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はじめに 

この度 は， MSX-C Library をお 求め 下さいまして ありがとう ございます， 

MSX-C Library は MSX の グラフ ィ ック 機能 や マウス， プリンタ などの 補助 入出力 装置 を 扱 

つたり， 現在の MSX- C の バー ジョン （VER 1 . 1) では サ ポ一 卜 さ れ ていない 倍精度 実数 や LONG 

型 演算 をサ ポー 卜する ライ ブラ リ パッケージです. 
MSX-C バージョン 1.0 および 1.1 では 標準 ライ ブラ リ しか 用意され ていない ために， C 言語 

か ら 直接， MSX の 特徴で あ る グラフィック 機能 や マ ウス， プリンタ 等 を 使用 する こと はでき ませ 

ん でした. 

MSX-C Library を 使用す る ことにより， C 言語での プログラミング だけで MSX の ほとんど 
の 機能 を 使う ことができ， 本格的に プログラム 開発 をされ る 方に も， また， これから C 言語 を 学 
ばれる 方 に も ご 利用 いただけます. 

なお， 本 ソフト ゥヱァ に は MSX-DOS, スクリーン エディタ， MSX'M-80， MSX-L-80, LIB 
-80， CREF-80, MSX- C は 含まれて おりません. MSX- C Library を 使用して プログラム 開発 を 
行なう 場合に は これらの ソフトウェアが 必要と なります ので， お持ちで ない 方 は 「MSX-DOS 
TOOLS」，. 「MSX-C Ver.l.lj をお 買い求め 下さい. また， プログラム 開発 を 行なう 上で デバ ッ 
グを 効率的に 行なうた めに， MSX 用 シンボリック デバッガ 「MSX-SBUG」 が 用意され てい ま 
すので， お持ちで ない 方 は 是非お 買い求め 下さい. 

本ゾフ トウ ヱ ァをご 使用になる 前に， 添付の 「ソフトウェア 使用 承諾 契約書」 をよ くお 読みい 
ただき， ご 確認のう え， 添付の ユーザー 登録 カードに ご 記入し， 弊社まで ご 返送 下さい. ご 返送 
を もって 承諾 契約書に ご 同意いた だいた ものと いたします. 

この 「ユーザ— 登録 カード」 を ご 返送いた だけない 場合に は， 弊社と いたしまして は 所定の ァ 
フタ 一 サービス をいた しかね ますので， よろしく ご了承の ほどお 願い 申し上げます。 

本ノ 《ッケ 一 ジ に は 以下の ものが 含まれて います. 

■ MSX-C Library システム ディスク 1 枚 

(3.5- 1DD フロッ ピー ディスク） 

■ MSX-C Library ユーザーズ マニュアル 1 冊 

■CS3， MSX-DOS, MSX-M-80, MSX-L-80, MSX-C は アスキーの 商標です. 

■ MS-DOS は 米国 マ イク 口 ソフト 社の 商標です. 

■ Z80 は Zilog, Inc. の 商標です. 

■ UNIX 才 ペレ一 ティ ング システム は 米国 AT&T の ベル 研究所が 開発し， AT&T が ライセンス 
しています. 



© ASCII CORPORATION 1988 



ご注意 

(1 にの ソフトウェア ならびに マニュアル を 賃貸 業に 使用す る こと を 禁じます. また， この ソフト 
ウェア や マニュアルの一 部 または 全部 を 無断で コ ピーす る こと はでき ません. 

(2) この ソフト ゥヱァ は， 製品 登録 カード を 返送して 当社に 登録済みの 方に 限り， 使用したり コピ 
一したり する ことができます. なお， この ソフトウェア を 個人 使用 以外の 目的で コピーす る こ 
と はでき ません. 

(3) この マニュアルに 記載され ている 胃 は， 将来 予告な く 変更す る ことがあり ますが， 当社に 登 
録 されて いる 方に は 案内 をお 送り します. 

一 

(4) 製品の 内容に ついては 万全 を 期して おります 力ま， 製品の 内容に ついての ご 不審 や， 誤り， マ 二 
ュ アルの 記載 もれな ど， お気付きの ことが ございましたら， マニュアルの 巻末の 「お問い 合わ 
せ」 についての 要領で 下記の 問い合わせ先へ お送り 下さい. 

(5) この ソフトウェア を 運用した 結果の 影響に ついては， （4) 項に かかわらず， 責任 を 負い かねます 
ので ご了承 下さ レ\ 

お問い合わせ 先 〒 107- 24 東京都 港 区 南靑山 6-11- 1 ス リー エフ 南 青山 ビル 

株式会社 アスキー ユーザー サポート 係 

TEL. 03-3498-0299 (祝祭日 を 除く 月〜 金） 
10:00 〜： 12:00， 13:00〜17:00 

(6) MSX-C Ver.1.1 お よ び MSX-C Library を 使用して 作成され た プログラムの 販売に ついて は， 

下記 に お 問 い 合わせ 下さい. 一 

お問い合わせ 先 〒 107- 24 東京都 港 区 南 青山 5-11- 5 住友 南 青山 ビル 

株式会社 アスキー システム 事業部 

TEL. 03-3486-8346 (祝祭日 を 除く 月〜 金） 
ほ 00〜12:00， 13:00 〜： L7:00 
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序章 MSX- C ラ ィ ブラ リ ' 、、ッ ケージの 概要 

序章 MSX-C ラ< ；ラリ パッケージ 麵 



0.1 ライブラリ 関数 要 

本 パッケージ は MSX-C で MSX の グラフ ィ ック 機能 や マウス， プリ ンタ などの 補助 入出力 装 
置 を 扱かった り， 現在の MSX- C の バージョン （VFJR.1.1) では サ ポー ト されて いない 倍精度 実数 
や Long 型 演算 を サボ 一 ト する ライ ブラ リ バッケ ージ です. 

以下に 本 パッケージの 関数 を 大きく 4 つに 分けて， 具体的な 内容 を 示します. 



クラ フィックス 関数 パッケージ 

線画 （ライン） や 塗りつぶし （ペイント） から， スプ ライト， VDP への アクセスまで， MSX のす 
ぐ れた グラフィック 機能 を 幅広 く サポート する M 数が 用意 されて います. 



数値 演算 関数 パッケージ 

数値 演 ^£ [を 扱う 関数 群 は 大き く 二つに 分ける ことができます. まず, MSX-C では サボ一 ト され 
ていない LONG 型 (4 バイ ト 整数， 本 パッケージ では SLONG 型と して 扱う） での 四 則 演算 を 行 
うため の 関数. そして， MSX-BAS1C と 同様の 倍精度 実数 型の 演算 を 行う 関数 群で 構成され ま 
す. 



- その他の 関数 

その他の 関数と して， MSX の 機能 を 拡張する マウス や プリ ンタ， ライ 卜 ペンな どの 補助 入出力 
装 H を 扱う 関数 や， スロッ ト 問での 関数 呼び出し を 行うた めの 命令な どが 用意され ています. 



カーソル 制御 (MSX-CURSES) 闋数 パッケージ 

CURSES (カーサ ス） と は 本来， UNIX という ミニコンピュータ 用の OS 上の， コンソール 画面 
への 文字 表示 や キヤ ラ クタ ウィンドウ を サポート する ための ライブラリ 関数の 総称です. MSX- 
CURSES は サブ セ ッ ト （一部分） なが ら CURSES の 仕様 を MSX- DOS 上で 実現す る ものです. 
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0.E 本 マ: アルの 構成 

本 マニュアル では ライ ブラ リ閼数 全体 を 上に 述べた 4 つの 関数 パッケージに 分けて 解説して い 
ます. 

以下の 章で は， まず 本 パッケージの 意義と 位置づけ， パッケージに 含まれる ファイル や， ライ 
ブラ リ 関数の 全般的な 使い方 を 述べた 後， 4 つの 関数 群に ついて 詳細に 具体的な 関数の 仕様と そ 
の 使用法 や， 注意事項 について 解説して いきます， 



第 i^ 本バ 'ケージの 義 とその 位； a づけ 



第瑋 本 パッケージの 意 ic!: その 位置づけ 

MSX-C コ ン パイ ラ のパッ ケージに 標準 ライ ブラ リ と して 付属して いる 関数 群 を 見渡して， 「グ 
ラフィック は 使えない の？」 とか 「音 は 出せない のか， BASIC でで きる のに」 といった 疑問 を も 
たれた 方 も 多い かと 思います. ここで は そもそも 標準 ライブラリと は 何 か， 本 パッケージの ライ 
ブラ リ とどん な M 係に あるの かにつ いて 解説し ます. 



1.1 標準 C ライブラリ 

C 言語が UNIX という ミニコンピュータ 用の OS (オペ レー ティ ング システム） 上の プロ グラ ミ 
ング 言語と して 発展し， また UNIX システム そのもの も， その 大部分が C 言語に より プログラム 
されて いると いう こと はよ く 知られて います. UNIX システムが 世界中の 大学， その他の 研究 機 
閬で 長い 年月 を かけて 進歩して きたのと 同様に， C 言語に ついても UNIX の 発展と 共に 育った 言 
語で あるた めに， FORTRAN や COBOL の 様に， 厳密な 工業規格の 形で は その 言語 仕様の 定義が 
なされて いません. そこで， UNIX の C の 設計者 自身が その 著書 「プログラミング 言語 C」 （リツ 
チ一 と 力一 二 ハン） で 示した 仕様が 一応の 標準 として 多くの C の 処理 系が これに 準拠した 形で 設 
計され てきました （MSX-C も その 一つで ある）， さらに， C 言語の 普及に ともなって， より 厳密な 
標準 規格化への 試みが 進め られ ています (ANSI や JIS な ど) ， これら の 標準化 案 も 基本的に， 
UNIX-C を 土台と した ものである こと は 言う まで も あり ません. 

こうした C 言語の 文法 上の 標準化と 同時に， ライブラリ について も 標準 ライ ブラ リ と しての 標 
準 化が 進められ ています. 標準 ライ ブラ リ もまた UNIX- C の ライブラリ を 基礎に しています， 
UNIX-C の ライ ブラ リ は 本来， その 多 く が UNIX ンス テム その も のの 持つ 機能 を 呼び出す いわ 
ゆる システム コールと， c 言語との ィ ンタ一 フェースと いう 性格 を 持ちます. もう 少し 分かりやす 
く 言う と， 例えば， UNIX の C コンパイラで， read() や writeO などの 関数 を 用いた プログラム 
を コンパイル する と， 実際に ディスク に対して 読み書き をす る コードが 生成され る わけで なく， 
READ, WRITE という システム コール を， それぞれに 必要な バラ メータ をセッ ト して 呼び出す コ 
一 ド に 展開 される にすぎない のです. 

そ れ では， MSX-DOS 上で read () や write 0 のよう な 関数 を 実現す る に は どうしたら よいで し 
よう. MSX- DOS に は READ や WRITE と 同一 仕様の システム コールはありません. しかし， 
MSXDOS にも ディスクの 読み書き を 行う システム コール は ある わけです から， 内部的に は それ 
ら を 用いて， C 言語の プロ グラムから は UNIX と 同様の 関数 呼び出 し を 行うよう にす る こと は 可 
能な わけです. すなわち， ライブラリ という 形で， システムと ユーザ プログラムとの 間の 
インター フェース を 統一す る こと で UNIX と MSX- DOS という システム の 違いが 吸収 さ れた の です. 

標準 ライ ブラ リ という 発想の 意義 は まさしく こ の 点に あ り， ライ ブラ リ の 外部 的な 仕様 (関数 名 
や， 引き数， 戻り 値な ど 取り決め） の 統一が， それらの 関数 を 使って プログラムして いるかぎ り 他 
の シス テ ム への 移植 を 非常 に 容易な ものと している の です (場合 によって は 単に コンパイルし 直 
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すだけ でよ い). 



こんな わけで， C 言語の ライブラリ である 以上， 標準 的な C ライブラリ （現在のところ UNIX- 
C ライ ブラ リ ） の ft 様 はでき る だ け 満た すよう にしなくて はな り ません. ま た， 仮に MSX- C 独自 
の 関数 を ライブラリ として 用意す るに しても， それら を 標準 ライブラリと 混同す る こと は， C 言語 
本来の 移植性の 妨げに もなる でしよう. 

MSX-C verl.l の マニュアルに おいても UNIX- C との ライ ブラ リ 関数の 仕樣 上の 違い を 特に 
あげてい るの は， MSX- C を 使いこな すため はもち ろん ，ユーザに そのこと をと く に 意識して プロ 
グラム をして いただく ためで もあった のです. 



1 .g 。ラ^^ラ リパッ ケージ g>fa 置 づけ リ 

し 力、 し， MSX の ユーザに して みれば， UNIX や MS- DOS などへの 移植性 もさる ことながら， 
MSX の もつ すぐれた グラフ ィ ック 機能 や， ジョイ ス ティ ックゃ マウスな どの 特殊 装置 を 十分に 
活かした プログラム を 作りたい と 考える の も 当然の 要請でしょう. 本 パッケージ はこうした 要請 
から， C コン バイ ラの パッケージと は 別個に （標準と いう こと を 問題に しない） MSX 独自の 数々 
の 機能 を C 言語に より 用いる ための ライ ブラ リバ ッ ケージな のです. 

本 パッケージ を このよ う に 位置づける と， MSX-BASIC を 手本と して 閲 数の 仕様 を 決める とい 
つたこと が 考えられます. MSX-BASIC はおよ そ MSX の 機能 を フルに サボ一 ト している ので 
MSX 専用の ライブラリ をつ くるに は 大いに 参考と なる わけです. ただ， C の 関数 を BASIC の 命 
令と まったく 同じ 仕様に したので は， C 本来の 柔軟性 や エラー チ: c ックは ユーザ 自身が プロ ダラ 
ムで 行い， 関数の 機能 は できるだけ プリ ミ ティブな ものにする という 思想から も 外れて しまい ま 
す (極端な 話 間違った 関数の 使い方 をす ると syntax error など ど 表示され たので はた まり ませ 
ん )• 

そこで， 本 パッケージ は， MSX-BASIC を 大いに 意識して 広く MSX の 機能 をサ ポー ト しなが リ 
らも， 個々 の 関数の 機能 を 単純に して， エラー チェック など は ユーザの 裁量に 任せる ようになつ 
ています. 従って， ある 意味で は BASIC のように 単純に は 行かない のです が， ユーザが より 自由 
に 「C らしい」 プログラム を 書く ことができる でしよう. 

また， 第 6 章で 詳しく述べて いますが， 本 パッケージに は MSX-CURSES という Iffl 数 群が 含 ま 
れ ています. CURSES (カーサ ス） と は UNIX 上の 「H 面 更新と 力一 ソル 動作の 最適化の ための ラ 
ィ ブラ リ パッケージ」， すなわち テキス 卜 画面 を 扱う アプリ ケーシ ヨンの ための M 数 群の 総称で 
す. この 説明で はちよ つと ピンと こない かも 知れません が， UNIX 上の スクリーン エディタ vi 
や， ロール プレイ ング ゲームの 元祖と も 言うべき Rogue (ローグ） などが CURSES を 用いた アブ 
リ ケーシ ヨンと して 知られて います. 

MSX-CURSES は その 名のと おり UNIX の CURSES の サブ セッ ト （一部分） となって います （一 
部 関数の 仕様が 異なる ところ も ある）， この 点で は MSX- CURSES の 関数 こついて は， グラフ 
ィ ック など を 扱う 他の 関数と は 区別す る 必要が あるか もしれ ません. 
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第 2 章 MSX-C ラ ィ ブラ リバ ッ ケージの 使 ffl 法 



第 2 童 MSX-C ライブラリ パッケージの ffiffl 法 

E.1 パッケージの 内容 

本 パッケージ に 付属の ディスクに 含まれる フ アイ ルの一 覧を 示し ま す. 

7T ^ジ ェクト ファイル 

mlib.rel 
glib.rel 
math.rel 
msxbios . rel 
curses. rel 



MSX-C ライブラリの オブジェクト ファイル 

以下， MLIB.REL を 4 つに 関数 パッケージに 分割した オブジェ ク 卜 



，丁 CO ファイル 

mlib.tco 本ラ ィ ブラ リ 使用の プロ グラムの パラメ — タチ エツ ク ffl の. tco ファイル 

(標準 ラ ィ ブラ リ の lib.tco に 匹敵す る もの） 



ヘッダー ファイル 

glib.h 
math.h 
msxbios. h 
curses , h 



グラ フ イツ ク鬨数 群の 宣言 やい く つかの 型 定義な ど 

数値 演算 関数 群の 宣言 や， データの 型 定義な ど 

MSX の BIOS を 呼び出し ている 関数の 宣言な ど 

MSX- CURSES の 関数 群の 宣言 や データ 構造体の 型 定義な ど 



ユー サブ ログ ラム 作成 用 バッチ ファイル 

msxc.bat 本 ライ ブラ リを 用いて プログラム を 作成す るた めの バッチ 

MSX-C の パッケ 一 ジ に 付属す る c . bat に あたる もの 



ライブラリ ソースファイル 

glib, mac 
glibc.c 

mathmac . mac 
mathc . c 



prsc.c 

msxbios.mac 
msxbiosc.c 
cursesc ， c 
curses2.c 



ライ ブラ 1 J 保守 用の ファイル 

genall.bat 
gengnb.bat 
genmath . bat 
gcnbios.bat 
gencurs.bat 
genmlib.bat 
gentco.bat 
gen. bat 
glib.tco 
math . tco 
msxbios.tco 
curses, tco 



以下， curses . tco までの. tco ファイル は ライ ブラ リ に 変更 を 加え た 際 に 
mlib.tco を 再 作成す るた めの もので， 実際の バラ メータ チヱ ックに は 
mlib.tco のみで 足り る. 



ユーティリティー プログラム 

echo.com ライ ブラ リ再 作成の 際に もちいる プログラム 

mx.com 同 ェ 

サンプル プログラム ファイル 

den.c 
den . com 
show . c 
show . com 
gcal.c 
gcal.com 



その他 

m ksys .bat 本 パッケージ を 用いた プログラム 開発 環境 ディスク をつ くるた めの バッチ 
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forremk . bat ラ ィ ブ ラ リ 再 作成 用 の システム ファイル をつ くる バッチ 

readme.doc 最新の 更新 事項の 情報 

E.E ライブラリ パッケージの 使用法 

本 パッケージ に 付属 の ディスクに は MSX-DOS の システム や， MSX-C コンパイラ そのもの， 
標準 ラ ィ ブラ リ な ど プロ グ ラムの 開発に 必要な フ アイ ルが 含まれて いません. 

そこで， まず はじめに する こと は， いままで お使いの MSX-C コンパイラの システム ディスク 
に 本 パッケージ 中から 必要な ファイル をコ ビ 一するな どして， プログラムの 開発 環境と しての シ 
ス テム ディスク を 作る ことです. 
一 通常の 本 ライ ブラ リ を 用いての プログラム 開発で は， いままでに お使いの MSX-C コ ン バイ ラ 

の システム ディ スク に， 本バッ ケージ 付属の ディスクから 以下の ファイル を コビ一 すれば 足り る 
でしよ う. 

バッチ ファイル 

msxc.bat 

ライブラリ ファイル 

mlib.rel 

パラメータ チェック 用 TCO ファイル 

mlib.tco 

ヘッダー ファイル 

一 glib.h 

msxbios.h 
math . h 
curses. h 

'ま た， 本 パッケージに は， 新しくお ろした ての ディスクから MSX-DOS-TOOLS や MSX- C コ 
ン バイ ラ ver.1.1 の ディ スク から 必要な ファイル を 次々 と コピーし， システム ディスク をつ く 
るた めの バッチ， niksys.bat も 用意され ています. この バッチ を 用いて システム ディスク を 作成 
する に は 本 パッケージの ディスク， 新しく フォー マツ ト した ディスクの 他に MSX-DOS-TOOLS 
や MSX- C コンパイラ ver . 1 . 1 の ディ ス ク が 必要です. 

mksys-bat の 起動 法 

まず， 新しい ディスクに mksys.bat を コピーして 下さい. 次に その ディスク を カレント ドライ 
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ブに 挿入し， MSX- DOS 上で 次のように 入力して ください. ディスクの ライ ト プロテクト ははず 
してお いて 下さい， 



A>mk$ys <ド ライフ 名 > @ (ドライブ 名の 指定に コロン はいりません） 

ドライ ブ名は 省略で きません. ドライ ブが 1 台の 場合 は 2 ドライブ シミュ レー タを 用いて 下さ 
い. ドライ ブ 名の 指定に コロン （ ， ： ， ） は 必要 あ り ま せん， 実際の mksys.bat の 起動 は 次の よ う に 
なります. 

A>mksys b \J\ 

こ れでノ < ッ チ が 起動 さ れ， TOOLS や MSX-C ver 丄 1 の ディスクの 揷入を 要求す る メッセ 一 
ジが 表示され ますから， それにしたがって ディスクの 入れ替え をして やれば， 新しい ディスクに 
次々 に 必要な フ アイ ルが コピーされ システム ディスク がで き あがります. 

g-g- 1 ソースファイルの 作成 (ヘッダー ファ イルの インクルード) _ 

C では， 関数 を プログラムで 用いる 場合， 用いる 関数 を 予め 宣言して おくのが 原則です. 標準 ラ 
ィ ブラ リ の 場合 は stdio . h などの ヘッダ一 ファイルと 呼ばれる 特殊な ファイル を インクルードす 
る ことによ り ユーザ プログラムの ソース 内で いちいち 個々 の 閧数を 宣言し なくて すみました. 

本 パッケージ でも 同じように， 関数の 宣言 や データの 型 宣言な ど をお こなって いる ファイル を 

用意して います. これら を 必要に応じて ィ ンク ルードす る ことによ り ユーザ は その プログラム 内 
で 自由に ライ ブラ リ 関数 や 定義され た 定数な ど を 使う こ とがで き ます. 

インク ルー ド 用のへ ッ ダーフ アイ ルに は 下の ような ものが あります. 

glib.h 
math.h 
msxoios.h 
curses, h 

インクルードすべき ヘッダー ファイル は 用いる 関数に よって 異なります. 具体的に は 次章 以下 
の 各 関数^^の 使用法 を ご覧 下さい. 

g,g,g コンパイル 

ソース フ アイ ルが 書け た ら 通常 どお り に コ ン パイ ル しま すが， この 際 MSX-C のパ ッ ケージ に 
^まれて いる c.bat などの， FPC によ り バラ メータ チヱ ックを 行って いる バッチ 処理で は 確実に 
エラーが 起こ り ます. なぜなら c.bat で FPC の チェックの 対象と している lib. tco では 本 パッケ 
一 ジ の 関数 は まったく 定義され ていない からです. 
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そこで， 本 パッケージの 全ての 関数の プロ ト タイプ 宣言 (関数の 骨組み だけ を 定義して いる） を 
含む TCO ファイル， mlib.tco を 併せて FPC にわた す こ とに より パラメータ チェック を 正常に 
行う ことができます. 

バラ メータ チヱ ックの 書式 は 以下の 様になる でしよう. 

f pc lib ml i b prog 

この 例で は ユーザ プロ グラム ファイル prog.c を CF にかけ て 生成した prog.tco のバ ラメ 一 
タ チェック を 行って います. 

もう ひとつ CF について 述べて おかな く て はならない ことがあり ます. ソースファイルで ィ ン 
クル一 ド する ヘッダ一 ファイル のなかで は 多くの 関数 や 定数， 変数が 定義され ています. CF 実行 
時には， これらの グローバルに 定義され た 関数 名 や 変数 名な ど は ソースの なかでの 参照の 有無に 
関係な く， そのための シンボル テーブルが つくられます. このため， stdio.h のみ を インクルード 
していた 場合に 比して， CF 実行時に シンボル テーブル オーバ一 フローの エラ一 がお きやすくな 
ります， この場合 CF の オプション によ り シンボル テーブルの 割合 を 少し 增ゃ してやる ことによ 
り ほとんど エラーな く 終了す る ことができます. 

後述の ノ s、 ッ チ msxc . bat でも CF 実行時の ォ プシ ヨンの 指定が 可能 になって います. 

E.g,3 リンク 

コ ンバ ィ ルが 済んだ ら ライブラリ の 本体で あ る REL (mlib.rel) ファイル も 含めて リンク を 行 
います. 本 パッケージの ライ ブラ リファイ ルは， ただ 1 つの REL ファイルに まとめられ ています 
が， 正式な ライ ブラ リ化 により 作成され ています ので リ ンカ （MSX-L80) の/ S オプション によ 
り 必要な モ ジ ュ ールだ け を 抜き出 して 結合す る ことができ ま す. 

ライ ブラ リファイ ル名は mlib.rel です. 本 ライ ブラ リ 関数 を 用いた プログラムの リ ンクの 際に 
は 必ず これ をリ ンク する 必要が あり ます. 

リ ンクの 際に は， mlib.rel は， 標準 ライ ブラ リファイ ル dib.rel や ランタイム ライ ブラ リファイ 
ル cnm.rel, cend.rel よりも 前に リンクして ください. 本 パッケージの ライブラリ 閲数 のなかに 
は 標準 ライ ブラ リ を 内部で 呼び出して いるもの や， 標準 ライ ブラ リ 関数と 名前が 重複す る ものが 
あるから です. 

リ ンクの 書式 例 を 示します. 



I 正しい 例 | 

1 80 ck, prog, ml ib/s,cl ib/s,crun/s f cemJ , prog/n/y/e ： xma i n 
I 誤った 例 I 

180 ck,prog,cl ib/s,ml i b/s t crun/s*cend ,prog/n/y/e:xtnain 



1 1 



(この場合 未定 議 エラーが でたり， 同じ 名前の 標準 ライ ブラ リ を リンク してし まう 場合が ある) 



以上， ユーザ ァロ グラムの 作成 手順 をお おまかに 追ってみ たわけで すが， ここまでの 一連の 処 

理を バッチ ファイル にした ものが msxc . bat と して 提供され ています. 

msxc.bat の 内容 は 以下のと おりです. バッチ 起動時の バラ メータの 2 番目， 3 番目が それや 
れ， CF， CG の オプション 指定に 用いられる のが わかる でしよう. 

cf %2 %\ 
fpc %\ ml ib lib 
eg -k %l 
m80 =5； 1/2 
del %\ .mac 

180 ck，Xl ,ml ib/s,cl i b/s , c ru n/s , cend , % 1 /n/y /e ： xma i n 

また， mlib.rel は 本 パッケージの 全ての 関数 を 含んだ ファイルでした 力く， これ を 4 つの 関数 群 
にわけ た ファイル も 用意され てい ま す. 

glib.rel グラフ ィ ック 関数 パッケージ 

math.rel 数値 演算 関数 バ ッ ケージ 

msxbios . rel マウス や プリンタな ど 基本的 人出 力 関数 ノ 《ッ ケージ （本 マ 二 ユア ル では そ 

の 他の 関数と して 分類され ている） 
curses. rel MSX-CUKSES パッケージ 

たとえば Long 型の 演算 関数の み を 使う 場合に は， mlib.rel にかえて mat ヒ rel をリ ンク する 
ことによ り 多少 リンクに 要する 時間が 短縮で きる ことがあります. 

ただし， 個々 の ライブラリ 関数の 中には， 内部的に， 他の 関数 群に 属する 関数 を 呼び出し てい 
る ものが いくつか あります. この場合， リンカ は 呼び出され ている 関数の 実体 を 与えられた REL 
ファイルから 見つける ことができず， 未定義 エラ一 となります. こうした 際に は mlib.rel で リン 
ク しなおして 下さい. 



5.3 ライブラリの 保守 

ユーザが 本 ライ ブラ リ を 使い込む うちに 関数の 細かい 仕様 を 改良した り， 新たに 自分で 作成し 
た サブルーチン を ライ ブラ リ に加えた いと 思う ことがある でしよう， 本 パッケージに は ライ ブラ 
リの 本体で ある RKL ファイル を 再 作成す るた めに 必要な 全ての ソースファイル を 含んで います 
ので， 各 ユーザが ソース レベルで 改編して 自由に 自分な りの ライ ブラ リバ ッ ケージ を 完成して い 
く ことができます， 
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2.3.1 ソースファイルの 作成 

ライ ブラ リの ソース を 直接 編集して 新しい ライ ブラ リファイ ルの 作成まで を 行う わけです から， 
作業の 前に もとの ライ ブラ リの バックアップ を 作って おく こと をお すすめし ます. 
ノ ズック アップの 取り 方 

MSX-C ライ ブラ リ パッケージの ディスク を ドライブ A に 入れ， フォー マツ ト 済みの ディスク 
を ドライブ B に 入れ (2 ドライブ シミュレータ の 場合 は 入れずに） ， 次の ような コマンド を 実行 し 
ます. 

A>copy a:*.# b: 0 
一 (実際の 表示 省略） 

2 ドライブ シミュレータの 場合 は MSX-DOS からの メ ッ セージに 従って ディスク を 交換して 下 
さい. MSX-DOS の プロンプトの A〉 が 出たら バックアップ は 完了し ました， ソースファイルの 
編集な ど は この バックアップ さ れた ディスクで おこなって 下さい. 

次に エディタ を 起動して ソースファイル を 編集し ます. 

ここで 注意すべき なの は ソースファイル 中の 関数のお かれる 順番です. 最終的な 目標で ある 
glib.rel,mlib.rel など は， リ ンク 時に 必要な 関数 だけ を 抜き出す ことができる 本格的な ライ ブラ 
リ ですから， この場合， ライブラリ 関数 内で 別の ライブラリ 関数の 呼び出し を 行って いると きに 
は， 呼ばれる 側の 関数 は ソース 屮 では 必ず 呼ぶ 側よ り も 前で 定義され て （書かれて） いなくて はな 
り ません （この 理由に ついては MSX-C 付属の マニュアルの ライ ブラ リ の 作成の 項 を ご覧 下さ 
い). 

こう して 必 喪な 変更 を 加え， できあがった ファイル を ディスクに セーブ すれば ソースの 作成 は 
完了です. 

E.3-S へッ タウア ィルの 変更 

次 は 変更 を 加えた ソースに 対応す るへ ッ ダフ アイ ルに 新し く 加えた 関数の 宣言 を します. こう 
する ことで 新しく 加えた 関数 を， ヘッダ ファイル をィ ン クルー ド する だけで 使う こ とがで きる よ 
うになります. 

£•3,3 コンパイル， アセンブルと バッチ ファイル 

ヘッダ ファイルの 変更まで できたら， ソース を コンパイル， アセンブル します. これに は一 気 
に ライブラリ 化す る ための バ ッ チフ アイ ルが 用意 されて います. これ を 走 ら せる ことによ りすべ 

ての REL ファイルと TCO フ アイ ルを 生成し ます. 
こ こ で 使用す る バッチ ファイル は genall . bat です. 
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A) バッチ ファイル を 起動す る 前に 

ライ ブラ リファイ ルが 無事に 作成され る ま でに は 多 くの フ アイ ルがデ イス ク 上に 作ら れた り 消 
されたり， あるいは リネーム されたり します. ディスクの 容量が いっぱい になり バッチが 途中で 
止まって しまったり， 大事な ファイルが 消されて しまったり などの トラブル を 防ぐ ために ライブ 
ラリの 再 作成に は 専用に 1 枚 ディスク を 用意され る こと をお すすめし ます， ただし， ディスク ド 

ライブが 1 台の みの 方の 場合， 2 ドライブ シミュレータ により 2 枚の ディスク を 用いる ことが で 
き ま す 力、 処理 時間 と 手間が た レ 、へん 大 きいので 1 枚の ディスク で 行な う 方が 効率的 か も 知れ ま 
せん. 

■ 2 枚の ディスク を 用いる 場合 (2 ドライブ シミュレータの 場合 も 含む） 

1 枚 目の ディスクに は 下の ような フ アイ ルが 必要です. これ を ライブラリ 作成 用 の システム デ 
イス クと 呼びます. 

システム ディスク はふ だんお 使いの MSX-C 用の システム ディスクに 足りない ファイル を 本 
パッケージの ディスクから コピー すれば 良いで しょう. 必要な ファイル を コピーしたら ライ トプ 
ロテク 卜 を オン (書き込み 禁止 状態） にして おいて 下さい. 



システム ディスクに 必要な ファイル 

msxdos.sys 
command.com 

cf. com 

cg. com 
m80.com 
lib80.com 
fpc.com 
mx.com 
echo . com 
genall.bat 
genmath . bat 
gencurs.bat 
genglib.bat 
genbios.bat 
genmlib.bat 
gentco ， bat 
gen. bat 
arel.bat 



コ ン バイ ラ 本体， バーサ 
コンパイラ 本体， コード ジェネレータ 
アセンブラ 

ライブラリ マネージャ 
パラメータ チェ ッカ 

ライブラリ 保守 支援 ツール， 本バ ッ ケージに 付属の もの 
本パ ッケ— ジ に 付属の もの 

起動に 使う バッチ 



crel.bat 



最後に 起動 される バッチ （ .lib か ら ， rel への リネーム を 行な つてい る） 
TEMP . BAT の 生成に 必要な ファイル （ァセ ン ブラ 処理の プロ 卜 タイ プが 
定義され ている） 

同 上 (C プログラムの 処理の プロ ト タイプ） 
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staio.h 

bdosfunc.h 

glib.h 

math.h 

msxbios.h 

curses. h 

msxbiosc - c 

msxbios.mac 

glib に c 

glib, mac 

mathc.c 

mathmac . mac 

prsc.c 

cursesc.c 

curses2.c 



標準 入出力 ヘッダ一 ファイル 
MSX-C コンパイラ 1 . 1 に 付属の も の 
ヘッダー フ アイ ノレ 
ヘッダ— フ アイ ノレ 

へッ ター フ アイ ノレ 
へ ッ ダ一 ファイル 



関数 を 加えたり 変更した ソースファイル 



以上 34 ファイル 



もう 一枚の ディスク （これ を ここで は ワーク 用の ディ スク と 呼ぶ） は 新しくお ろした ディスク を 
フォーマットして ディスクの ライト プロ テク トは そのまま オフ （書き込みが できる 状態） にして お 

いてく たさい. ワーク ディスク は フォー マツ 卜 された ディ スク であれば 問題ありません. 



■ 1 枚の ディスク を 用いる 場合 

この場合 は， システム ディスクと ワーク ディスクが 兼用と なります. この場合 はふ だんお 使い 
の MSX-C の システム ディ スクを そのままお 使いになる ので はなく， 新しい ディ スクに 上記の 必 
要な ファイル だけ を コピーし， これ を ライ ブラ リ 作成 用の システム 兼 ワーク ディスク としてお 使 
い 下さい. そうしな いと バッチの 途中で ファイル を 作る ことができなくなる 場 含が あり， ライブ 
ラ リが再 作成で きません. 



B)GENALL.BAT の 起動 

必要な フ アイ ルが 揃つ ている こと を 確認したら genali .bat を 起動 してみ ましょう， 

■ 2 枚の ディスク を 用いる 場合 

まず カレント ドライブ (プロンプトが 、、A〉" なら A ドライブ） に 上の システム ディスク を いれ， 
もう 一方の ドライブに は 新しくお ろした ワーク ディスク を 入れて 下さい. このと き カレント ドラ 
イブの ディスク だけが ライ トプ ロテク ト された 状態です. 

ここで は ライ ブラ リ をす ベて 再 作成し ますから genall.bat に 渡す 引き数 は ファイル を 作成す 
る ドライブ 名です. カレント ドライブが A ドライブの 場合， 次のように コマンド 入力し ます. こ 
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れは 2 ドライブ シミュレータ により 2 枚の ディスク を 使う 場合 はまず カレン 卜 ドライブの デ イス 
クを いれて 同じ コマンド 入力と なり ます. （ただし 実際の オペレーション では 途中で ディスク 入れ 
替えの メ ッ セージが 表示され， それにしたがって ディスク を 入れ換えなくて はならない） 

A>genal I b @ (ドライブ 名の 指定に コロン はいりません） 
(実際の 表示 省略） 

■ 1 枚の ディスク を 用いる 場合 

必要な フ アイ ル がすべ て 入った ディスク （システム 兼 ワーク ディ スク） を カレン 卜 ドライブ にい 
れ ます. ライト プロテクト は オフです. この場合， ライブラリ ファイル を 作成す る ディスク は 力 
レント ドライブの ディスク という ことです から， GENALL の] 番目の 引き数 は カレン 卜 ドライ 
ブ名 となります， 

A>genal 1 a ^1 

(実際の 表示 省略） 



S.3.4 その他， 注意事 項 ― 

エラ一 がな く 最後の バッ チ gen.bat まで 実行が 終ったら， 新しい 関数 を 含んだ ライ ブラ リの出 
来 上りです. ふだんお 使いの MSX-C の ディスクに コピーして， これまでの MSX-C ライブラリ 
と同じように コンパイル， リンクが できます. 

これまで 書かれた よう にす る ことで， ユーザに あった MSX-C ライ ブラ リ にす る ことができ ま 
す 力 礼 genall バッチ を 1 回 実行す る の に 3 時 問 か ら 4 時間 ほ どか かってし まいます. です か ら 追 
加す る 関数 は 十分 デバッグ してから ライブラリ に加える こと をお すすめし ます， また， バッチ フ 
ァ ィ ルを 解析す る ことで より 短時間に ラ ィ ブラ リ を 更新す る こと がで き るの が 解る と 思います， 
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第 3* グラフ ィ y ク 関数 パッケージ 

第 3 章 グラフィック 関数 パッケージ ― 



3.1 グラフィック 関数 パッケージの 概要 

本 パッケージ 中には， グラフィック 画面 を 扱うた めに 数多くの 関数が 用意され ています. これ 
を さらに 下の よう な 7 つの 関数 群に 分類し それぞれ について 解説 を 行います. 

• 初期化 及び VRAM の アクセス に関する 関数 
• VDP の レジス タ を 操作す る 関数 
• 色 を 操作す る 関数 

• 描画 

*ス プライ 卜 

• ビッ 卜 ブロック 転送 

• その他の 関数 



3.1.1 初期化 及び VRAM の アクセス に関する 関数 

グラフ ィ ック 関数 を 使用す る 前に 必ず 呼ばなければ ならない 関数と， VRAM を アクセス する 
のに 必要な 関数 を 集めて あり ます. 



3.1-g VDP の レジスタ を 操作す る 関数 

VDP (9918 や 9938) の 内部 レジスタ を 読み 書 きする 関数 群です 



3.1,3 色 を 操作す る 関数 

フォアグラウンド， ノ 《ック グラウンド， ボーダーの 色 を 設定したり， バレット を 操作す る 関数 
群です. 

a 1,4 描画 ルーチン 

グラフ ィ ック 画面に 描く ための 関数 群. BASIC の LINE や CIRCLE などの 図形 を 描く ための 
命令に 相 肖 する ルーチン や， PAINT (塗 り つぶい や PSET (点描） な ど を 描画 ル一チ ン として こ 
の 部類に いれる ことができ るでしょう. 基本的に は， これらの 関数 は BASIC 的な 感覚で 使える の 
です が， ロジカル オペ レー ショ ン 指定が 可能 かどう かや， カラーの 有効 範囲な どが スク リーン モ 
ード によって異なる ため， 注意が 必要です. 
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3-1-5 ス ブライトに 関する ルーチン 

ス プライ トも 画面 表示に は 違いない のです 力、 単純に 点 や 線 を 描く のと は 違い ス プライ トの大 
きさ や キャラクタの パターン を 設定したり などの 前 準備が 必要です. 本 パッケージに は， スプラ 
ィ 卜 パターン や カラーの 設定から 実際の 表示までに 必要な 全ての ルーチンが 揃ってい ます. 

3-1-B ビット ブロック 転送 ルーチン 

ビッ ト ブロック 転送と いう とちよ つと 聞き なれない 言葉です が， BASIC の COPY 命令に 相当 
す る 一連の 関数 と 考 え れば良 いでしょう. 

こ れ ら の ルー チ ンを 用いる こと に よ つ て， デ ジ 夕 ィ ズゃ グラフィック ソフトな どで 作成した 画 
像 データ を C の プログラムで 自由 に 転送 し， 画面の 任意の 位置に 表示す る こと がで ま す. 

C 言語が 人工知能 などの プログラミング にも 適して いると 言われて いますので， 画像 データ さ 

えうまく 作れれば， ちょっと した ァ ド ベンチャー ゲームな ど をつ くる こと も 可能で しょ う， 

下位 レベルの 関数 (VRAM アクセス や VDP レジス タ の 操作な ど） を 除けば グラフィック を 扱 
う ほ とん どの 関数が， 機能の 面 か ら 考える と BASIC で 馴染みの も の ばか り です か ら ， 例 え ば， 「ス 
プライ 卜と は 何 か」 とか 「スクリーンモード による 具体的な 違い は 何 か」 などに ついては MSX- 
BASIC の マニュアル や， 「MSX2 テクニカル ハンドブック」 などの 解説 をご覽 下さい • 

但し， C では 引き数の 省略が できません し， また 細かい エラー チェック も 行って おりません の 
で， BASIC と 比較して， 引き数 や 戻り 値に 十分 注意した， よりきめ の 細かい プログラム を 心がけ 
ねばな り ません. 



3.E グラフィック 関数 パッケージの 使用法 



3,2-1 ソースファイルの 作成 

ライ ブラ リ 関数 群 はいって みれば 外部 定義され た （同一 ソース 以外で プログラム された） 関数の 

集まりで すから， これらの 関数 を 呼び出す さいに は # include プリ プロセッサ 文に よ り 予め 関数の 
宣言が 行われて いる ヘッダー ファイル を 読み込ま なく て はなり ません. 

stdio . h の インク ルー ド の 後で glib . h を インクルード する ことにより 本章で 解説す る グラフ ィ 
ック 関数 を ユーザ は 特に 宣言す る ことな く 用いる こ とがで き ます. ただし glib. h のなかで すべて 
の グラフィック 関数が 宣言 されて いる わ け で は な く ， glib . h の なか でさら に msxbias . h というへ 
ッ ダーフ アイ ルの 呼び出し を 行って いて， この 2 つのへ ッ ダ一 ファ ィ ルを あわせて はじめて ダラ 
フィック 関数の 宣言が 網羅 さ れる こと に な り ま す. 

本章で 解説す る グラフ ィ ック 関数 を 用いる プロ グラムの ソースの 先頭 部分 は 例えば 次の よう に 
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第 3$ ダラ フィ ッ ク 関数 パッケージ 



なる でしよう. 
# pragma nonrec" 

» include <stdio.h> O ヘッダーの ィ ンク ルード 

# include <gl ib.h> 



funcKf ore, back, b ひ rd〉 
TINV fore, back, bord; 
{ 

^ screen((TINY)8); O 実際に グラフィック 関数 を 用いて いる 部分 

col or ひ ore, back ， bord) 



glib. h のなかで は 関数の 宣言 だけで はなく いくつかの 型 や 定数の 定義な ども おこなわれ てい 
ます. glib. h で 定義され た 型な どに ついては これら を 用いる 必要の ある 個々 の 関数の 解説 中で そ 
のつ ど 解説し ます. 

3.S,S コンパイル， リンク 

前節で 述べた よう に glib.h のなかで nisxbios.h がィ ン クルー ド されて いますので， cf (コ ンパ 
ィ ラの フロントエンド） を かける 際に は， カレン 卜 ドライ ブの ディ スクに は glib.h の ほかに 
msxbios.h が 必要です， 

第 2 章で 述べた よ う に， 本バ ッ ケージで は， バラ メータ チェック 用の TCO ファイル や ライ ブラ 
リファイ ル （REL ファイル） は 関数 群 毎に 分けず， それぞれ 1 ファイルに まとめて いますので， パ 
ラ メータ チェックに ついては 

ml ib. tco 

リ ンクの 際に は 

mi ib. rel 

を fpc， 180 の バラ メータと して 与えます. 詳しく は 2. 2 を ご覧 下さい. 
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3.3 グラフィック 関数 一覧 



初期化 及 び VRAM の アクセス に関する 関数 



間 *(r ク 
1 共〗 奴る 


m ま 


麥 お へ * 


H う 
一 ン 


ginit 


グラフ ィ ック 関数 を 呼ぶ 前に 必ず 呼ぶ 関数 




23 


interlace 


ィ ンタ 一レース モードの 設定 




23 


setrd 


VDP を 読み込み モー ドに 設定す る 




24 


invdp * 


VRAM から 1 バイ 卜 データ を 読み込む 




24 


setwrt 


VDP を S き 込み モー ドに 設定す る 




24 


outvdp * 


VRAM に 1 バイトの デー タ を ,if き 込む 




24 


vpeek 


VRAM の 指定した アドレス の 内容 を 返す 




24 


vpoke 


VRAM に 1 バイ トの データ を 書き込む 




24 


filvrm 


VRAM の 指定 領域 を 指定の 1 バイ ト のデ一 


タでク リアす る 


24 


ldirmv 


VRAM から メインメモリへの デー タ 転送 




25 


ldirvm 


メインメモリから VRAM への データ 転送 
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VDP の レジスタ を 操作す る 関数 



瞧名 


用 途 


参照 ページ 


wrtvap 


VDP の コントロール レジスタに データ を S き 込む 


25 


rdvdp * 


VDP の コントロール レジスタ の 内容 を 読み込む 


25 


rdvsts 


VDP の ステータス レジスタ の 値 を 返す 


26 



色 を 操作す る 関数 



関数 名 


用 途 参照 ページ 


color 


スクリーンの フォア グランド， ノ ハソク グラウンド， ボーダーの 色 設定 

26 


iniplt 


バ レツ 卜 及び VRAM に 保存され たパ レツ ト データの 初期化 26 


rstplt 


VRAM から バ レツ ト データ を リストア する 26 


gctplt 


パ レツ トの 内容 を 返す 27 


setplt 


ノく レツ 卜の セッ 卜 27 



11^1 * の 付いた 関数 は 割り込み フラグ を 変化 させません. それ 以外の 関数 は 「割り込み 
許可 J で 返って きます. 
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第 3 章 グラフ ィ ッ ク 関数 パッケージ 



描画 閱数 



関数 名 


用 途 参照 ページ 




グラ フ イツ ク 画面に 指定 色で 点 を 描 く 27 


line 


2 点の 指定 座標 を 結ぶ 直線 を 描 く 28 


box line 


2 点の 指定 座標 を 対角 とする 四角形 を 描 く 28 


boxfill 


2 点の 指定 座標 を 対角 とする 四角形 を 塗 り つぶす 29 


circle 


指定 座標 を 中心 とする 円 を 描く 29 


paint 


グラフ ィ ック 画面の 指定され た境枰 色で 囲まれた 部分 を 指定の 色で 塗 
り つぶす 29 


point 


グラ フ ィ ック 画面の 指定の 座標の 色コ 一 ド を 返す 30 


ス プライ ト 関係の 関数 


閬 数名 


用 途 参照 ページ 


inispr 


全ての ス プライ 卜の 初期化 30 


calpat * 


指定され たス プライ トバ ターンに 対応す るス プライ 卜 パターン テープ 
ルの 先頭 アドレス を 返す 31 


calatr * 


指定した ス プライ ト 面に 対応す るス プライ 卜ァ 卜 リ ビュート テーブル 
の 先頭 アドレス を 返す 31 


sprite 


ス プライ トバ ターンの 設定 31 


colspr 


ス プライ 卜の ライン 毎の 色 を 指定す る 31 


putspr 


スプ ライトの 表示 32 



ビッ ト ブロック 転送 



関数 名 


用 途 


参照 ページ 


cpyv2v 


VRAM の 指定 ページ を 他の ベー ジへ 転送す る 


32 


cpyv2m 


VRAM の 指定べ" ジを メイン RAM に 転送す る 


33 


cpym2v 


メイン RAM の 画像 データ を VRAM へ 転送す る 


33 



そ の 他の グラフィック 関係の 関数 



関数 名 


用 途 参照 ぺー ジ 


totext 


スクリーンモード を テキス トモ一 ドに 戻す ：33 


grpprt 


現在の グラフ ィ ック カーソル 位置に一 文字 表示す る 34 


knjprt 


現在 の グラフィック カー ソ ル 位置 に JIS 漢字 コ 一 ド に 対応す る 文字 
を 表示す る 34 


giocate * 


力一 ソル 移動 34 


setpg 


VRAM の 表示 ぺ 一ジと 書き込み ページの 設定 35 


vramsixe * 


VRAM の サイ ズを 返す 関数 35 
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3.4 グラフィック 関数 リファレンス 

本節で は 個々 の 関数の 仕様と， その 用法の 解説 をお こない ます， 関数の' 解説に おいて， なじみ 
のうす いいく つかの 変数 型が 用 いられて いま すが， これ はへ ッ ダー ファイル のな かで つ ぎの よう 
に 定義され ています. 

TINY 符号な し 1 バイ ト 整数 型. すなわち， char に 定義 (typedef) されて いる. 
NAT 符号な し 2 バイ ト 整数 型. unsigned に 定義され ている. 

3,4,1 グラフィックに 関する システム 変数 

グラフ ィ ック 関数 群の ために 以下に あげる ような システム 変数が 用意され ています. これら は 

実際に は glib.h の 中で 定義 されて いる # define マクロ であ り ， MSX の ワーク エリア を 直接 参照 
します. 

TINY c dpage ； 
TINY c apage ； 

それぞれ 現在の 表示 ページ， アクティブ ページ を 保持して いる 変数です. 参照 は 自由にで きま 
すが， 直接 代入で きる の は c_apage だけです. c_dpage を 変更す る 際 は 必ず setpgO 関数 を 使用 し 
て く ださい. c_dpage に 直接 代入した 場合の 動作 は 保証され ません. 

TINY c—fore ； 
TINY c— back ； 
TINY c 一 bord ； 

それぞれ 現在の フォアグラウンド カラー， ノ くック グラウンド カラ一， ボーダー カラー を 保持し 
ている 変数です. 参照 は 自由にで きます が， 直接 代入で きる の は グラフィック モードに おける 
c_fore もしくは c_back だけです. テキス ト モー ド において もしくは に bord を 変更す る 際 は 必ず 
color 0 関数 を 使用して 代入して ください. 直接 代入した 場合の 動作 は 保証され ません. 

NAT cjastx ； 
NAT cjasty ； 

それぞれ 一番 最後に 指定され た X 座標， Y 座標 を 保持して いる 変数です. 参照， 代入と も 自由 
にで きます. また これら は glocateO 関数 を 使用 し て 設定す る こと もで きます. 
主 に 連続 した 直線 を 引く のに， line 0 関数と 共に 使用され ます. 
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第 3^ グラフ ィ ッ ク 関数 パッケージ 



TINY c— screen ； 
TINY c— sprite ； 

それぞれ 現在の スクリーンモード， スプ ライト サイズ を 保持して いる 変数です. 参照 は 自由に 
できます 力、 代入す るに は 必ず screen ()， inisprO 関数 を 使用して ください. 

NAT c xmax ； 
NAT c ymax ； 

それぞれ 現在の スクリーンモードで 表示で きる X 座標， Y 座標の 最大値 を 保持して います. 参 
照 は 自由にで きます が， 代入 はでき ません， 実際に は それぞれ， gtxmaxO, gtymax (Redefine 
されて います. 

3,4.g グラフィックに 関する 定数 

グラフ ィ ック 関数 群の ために 以下に あげる ような 定数が 用意され ています. これら は giib. h の 
中で 定義され ています. 



ロジ カル オペ レ- 


ーシ ヨン 


PSET 


0x00 


AND 


0x01 


OR 


0x02 


XOR 


0x03 


PRESET 


0x04 


TPSET 


0x08 


TAND 


0x09 


TOR 


0x0a 


TXOR 


0x0b 


TPRESET 


0x0c 



3,4.3 初期化 及び VRAM の アクセス に関する 関数 



VOID ginitO 

グラ フ イツ ク 関数 を 呼ぶ 前に 必ず この 関数 を 呼び出 して く ださ い. 
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VOID interlace (mode) 
TINY mode ； 



ィ ン ター レース モード を 設定し ます. ィ ン ター レース モードに ついては MSX-BASIC の マ 二 
ユア ルを 参照して くた さい. 

VOID setrd(adrs) 
NAT adrs ； 

VDP を adrs 番地からの 読み込み モー ド に 設定 します. 次の i nvc |pO と共に 使用 されます. 

TINY invdpO リ 

VRAM から 1 バイ ト データ を 読み込みます. 

VOID setwrt(adrs) 
NAT adrs ； 

VDP を adrs 番地 か らの 書き込み モード に 設定 します. 次の outvdpO と 共に 使用 されます. 

VOID outvdp(data) 
TINY data ； 

VRAM に 1 バイ ト データ を 書き込みます. 

TINY vpeek^vadrs) ン 
NAT vadrs ； 

VRAM の vadrs 番地の 内容 を 返します， 

VOI D vpoke (vadrs , data) 
NAT vadrs ； 
TINY data ； 

VRAM の vadrs 番地に data の 1 バイ 卜 をき き 込み ま す， 

VOID f ilvrm (vadrs, len, data) 
NAT vadrs ； 
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NAT len ； 
TINY data ； 

VRAM の vadrs で 指定 した アドレスからの len バイト を data の 値で うめます. 

VOID ldirmv(dst,src,len) 

TINY *dst ； 

NAT src ； 

NAT len ； 

VRAM から メインメモリへの データ 転送 を 行います， 

dst に 転送先の メイ ン RAM のァ ド レス， src は 転送 元の VRAM のァ ド レス， len に は 転送す る 
データ 長 を バイ ト 単位で 与えます， 

VOID ldirvm(dst,srcjen) 

NAT dst ； 

TINY *src ； 

NAT len ； 

メインメモリから VRAM へ データ を 転送し ます， 

dst に 転送先の VRAM の アドレス， src に 転送 元の メイン RAM の アドレス， len に は 転送す る 
データ 長 を バイ ト 単位で 与えます. 

3.4.4 VDP の レジスタ を 操作す る 関数 



VOI D wrtvdp (vreg , data) 
TINY reg ； 
TINY data ； 

VDP のコ ン トロール レジスタに データ を 叩き込みます. 
. vreg で レ ジ スタ 番号 を 指定し， data で 書 き 込む 値 を 渡します， vreg は VDP の レ ジ ス タ 番号で 
あ り ， MSX-BASIC の VDP コマンドと は 9 以上の 場合 1 つ ずれて いる こ と に 注意して く だ さ 
い. つまり MSX- BASIC での レジスタ 9 はこの 関数で は レジスタ 8 になり ます. 

TINY rdvdp(vreg) 
TINY vreg ； 

vreg で 指定 される VDP の コントロール レジスタ の 内容 を 読み込み ま す. vreg は VDP の レ ジ 
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ス タ 番号で あ り ， MSX- BASIC の VDP コマンドと は 9 以上の 場合 1 つ ずれて いる こと に 注意 し 
てくだ さい. つまり MSX-BASIC での レジスタ 1() はこの 関数で は レジスタ 9 になります. 

こ の 関数 は wrtvdpO を 使用 し て VDP の コントロール レジスタに 書き 込んだ 場合の み 有効で 
す. 1ノ0 命令で 直接 VDP の コントロール レジスタに 書き込んだ 時， この 関数の 動作 は 保証され 
ません. 

また vreg の 範囲 は 0 から 23 までです. 24 以上の 値 を 指定した ときの 動作 は 保証され ません. 



TINY rdvsts(sreg) 
TiNY sreg ； 

sreg で 指定 し た VDP の ステータス レジスタの 値 を 返します. MSX- BASIC の VDP 関数 と は 
レ ジス タの 指定 方法が 異なる こ と に 注意して く ださい， MSX-BASIC の VDP(8) は rdvsts(O) 
に， VDP(- 1) は rdvsts(l) に 相当し ます, 

3.4.5 色 を 操 る鬨数 



VOID color (fore , back , bord) 
TINY fore, bac に bord ； 

スクリ ユンの フォア グランド， バック グランド， ボーダーの 色 を 設定し ます. 
戻 り 値 は ありませ ん. 無効な 色 （スクリーン 2 上で 256 を 指定し た な ど） に対して の 動作 は 保証 
されません. 

^include <std i o.h> w 
# include <«l は i.h> 

/* フォア カラー を バックに， パック を ボーダーに， ボ一ダ を フォアに 変更す る */ 

VOID funcK) 
{ 

colorvc ho rd , c fore, c; back); 

} 

VOID inipltO 

ノ ヽ 。 レ ッ ト 及び VRAM に 保存 さ れたバ レ ッ 卜 デー タ を 初期化 します （ディフォルト 値に 戻す) . 
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VOID rstpltO 

VRAM から バレ ッ ト データ を リス トァ します. 

NAT getplt(pal) 
TINY pal ； 

pal で 指定され たパ レツ 卜 の 内容 を 返 します， 戻 り 値 と して NAT 型の 値 (setplt 参照） を 返し ま 
す. 



[ 使用例 | 

^include <stdio.h> 
^include <gl ib.h> 

/* 指定され た バレットの 緑の レベル を 最高に する */ 
VOID funcl(pal) 
TINY pal; 
{ 

NAT i; 

i = getpl t(pal )； 
setplt(pal, i I 0x700)； 

} 

VOID setplt (paLgrbdat) 
TINY pal ； 
舞 NAT grbdat ； 

バ レツ ト をセッ 卜します， 

pal で 設定したい バ レツ ト 番号 を 指定し ます *grbdat は 2 バイ トの 値で 下位の 12 ビット を 4 ビ 
ット 毎に 区切って グリーン， レッド， ブルーの 輝度 を 指定し ます， ビットの 割当 は 以下のと おり 
です. 

Msb+ + + + +Lsb 

無効 緑の 輝度 赤の 輝度 青の 輝度 

指定 された パレット データ は VRAM に 保存 されます， 
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3.4.6 翻 関数 



VO I D pset Kx t y t color , logop) 

NAT x,y ； 

TINY color ； 

TINY logop ； 

グラ フ ィ ック 画面に 指定 色で 点 を 描きます. 

(x , y) で 指定 し た 座標に color 色で 点 を 描き ま す. MSX2 マ シ ンの 場合， ロジカル オペ レー ショ 
ンの 指定が 有効です. 
x， y は 自動的に c—lastx, cjasty に 代入され ます. 

VOID Iine(xl,yl,x2,y2, color, logop) 

NAT xl,yl,x2,y2 ； 

TINY color ； 

TINY logop ； 

座標 (xl,yl) ，座標 (x2,y2) を 結ぶ 直線 を color で 指定した 色で 描きます. 

MSX2 マシンの 場合， logop で， BASIC と 同様の 口 ジ カル オペレーションの 指定が 可能です. 
MSX1 の 場合 や， ロジカル オペレーションの 指定の 必要がない 場合 は， logop は 省略せ ず 必ず 
PSET を 指定して ください. 

x2, ゾ 2 は 自動的に c jastx， cjasty に 代入され ます. 

| 使用例 | 

» include <stdio.h> 
< include <gl ib.h> 

/* 三角形の 表示 * ノ 

VOID funcK) 

{ 

line(0， 0, 100, 50, (TINY)15, PSET); 

I ine(cjasix, cjasty, 50, 300, (TINY) 15, PSET); 

1 ine(c lastx, c は sty, 0， 0， (TINV)15, PSET); 

} 

VOID boxline (x 1 , y 1 , x2 , y2 , color, logop) 
NAT xl,yl,x2,y2 ； 
TINY color ； 
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TINY logop ； 

座標 (xl，yl), 座標 (x2，y2) を 対角と する 四角形 を 描きます. それ 以外 は line と 同じです. 

VOID boxfil I (x 1 , y 1 , x2 , y 2 , color , logop) 
NAT xl,yl,x2,y2 ； 
TINY color ； 
TINY logop ； 

座標 (xl，yl), 座標 (x2,y2) を 対角と する 四角形 を 塗りつぶします. それ 以外 は line と 同じで 
す. 

VO I D circle (x , y , に color , s 一 angl , e_angl , aspect) 

NAT x t y f r ； 

TINY color ； 

int s 一 angl, e 一 angl ； 

NAT aspect ； 

座標 (x，y) を 中心とする 半径 r の 円 を color 色で 描き ます. s_angl, e_angl の 絶対値 は それぞれ 
円の 開始 角度， 終了 角度 を 指定し， 増加す る ごとに 反 時計回りに 角度が 変化し ます. 0 は 真 右， 
2000H は 真上， 4000H は 真 左， 6000H は 真下 を 指定し ます. s_angl, e_angl が 負の 場合 は 円の 中 
心へ 向けての 直線が 引かれます. 描画 は 開始 角度から 反 時計回りに 終了 角度まで 実行され ます. 

aspect はァ スぺク ト レシオで， 1H から 7FFFH までの 値が 指定され る と 横長の， 8001H から 
0FFFFH までの 値が 指定され ると 縦長の 楕円が 描画され ます. 80001- I が 指定され ると 真 円と な 
ります. 0 を 指定した 場合の 動作 は 保証され ません. 1 "は 常に 長径 を 指定し ます. aspect と MSX 
-BASIC の アスペクト レシオ の 関係 は 以下の ようになります. 

if (aspect <= 3276B) 

ァ スぺク 卜 レシオ = aspect I 32768； 

else 

ァ スぺク ト レシオ = 0x8000 I abs( 65536 - aspect )； 
MSX-BASIC と 違い color ，s_angl,e_angl,acpect は 省略で きません. BASIC の 

CIRCLE (128, 100), 80 

と 同じ 事 をさせる に は 例えば 以下の ようにして ください. 

circie(128, 100， 80， に fore, 0， 0x7fff , 0x8000)； 
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x, y は 自動的に c_lastx， cjasty に 代入され ます. 

VOID paint (x,y, color, b color) 

NAT x,y ； 

TINY color, bgcolor ； 

グラフィック 画面の 指定され た 境界 色で 囲 ま れた 部分 を 指定の 色で 塗 りつぶ します. 

本 ルーチン は スクリーンモード によって 多少 機能が 異なり ます. スク リーン モード 3 もしくは 
5 力、 ら 8 では， b_color 色で 囲 ま れた （x ,y) を 含む 領域 を color 色で 塗 りつぶ します， こ れに 対し ス 
クリーン モ— ド 2 ないし 4 の 場合 は 境界 色 (b_col( )r ) の 指定 は 無効で， color で 囲まれた 部分 を 
color 色で 塗りつぶします. 

スクリーン モードが 2 ないし 4 のとき は， b_color に は 必ず TINY 型の ダミーの 値 を いれて く 
ださい. 

x， y は 自動的に c_lasbc， cjasty に 代入され ます. 

TINY point (x,y) 
NAT x,y ； 

グラフ ィ ック 画面の 指定の 座標の 色 コード を 返します. 弓 I き 数と して 色 を 調べたい 座標 を 与え 
ます. グラフィック 関係の 他の 関数と 違い， cjastx, cjasty を 変更し ません， 

3.4.7 ス ブライ 卜 関係の 関数 



VOID inispr(size) 
TINY size ； 

全ての ス プライ トを 初期化し ます. 

ス プライ 卜 バタ一 ン はすべ て 0 で うめられ， カラー は， フォア グランド カラーに 初期化され ま 
す. そして， スプ ライト は 表示され ない 位置に おかれます （水平 位置が モード 0 から 3 では 209， 
モード 4 から 8 では 217). 

同時に ス プライ ト サイズが size で 指定した 値に 設定され ます. size の 取りうる 値 は 以下の通り 
です. 

0 ： 8X8 モード， 拡大な し. 
1 ： 8X8 モード， 縦横 拡大 あり. 

2 ： 16X16 モード， 拡大な し. 

3 ： 16X16 モード， 縦横 拡大 あり. 
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4 ： ス プライ 卜の 表示 を 禁止. 

4 の 「ス プライ トの 表示 を 禁止 j は MSX2 でのみ 有効で あり， MSX で size に 4 を 指定した 場 
合の 動作 は 保証され ません. 

NAT calpat^pat) 
TINY pat ； 

指定され たス プライ ト パターン (0 から 255) に 対応す るス プライ 卜 パターン テーブルの 先頭 ァ 
ドレス を 返します. 

NAT calatr (plane) 
TINY plane ； 

plane で 指定した ス プライ ト面 (0 から 31) に 対応す るス プライ トァ卜 リ ビュー トテ一 ブルの 先 
頭 アドレス を 返します. 

VOID sprite (pat f data) 
TINY pat, *data ； 

ス プライ 卜 パターン を 設定し ます. 

pat に 設定したい ス プライ ト パターン 番号， data に はス プライ トデ〜 タ への ポインタ を 与え ま 
す. ス プライ 卜 サイズが 8X8 の 時 は data で ポイント される データの 最初の 8 バイ トカ ％ 16X16 
の 場合 は 最初の 32 バイト が 使用 されます. 長さ が 必要 と さ れる データ 長に 満た ない とき は パター 
ンの 終わりの 方 は 不定です. 

VOID colspr (plane , color) 
TINY plane, *color ； 

ス ブライトの ライン 毎の 色 を 指定し ます. これにより， ス プライ 卜 パターンの ビットが 1 の 部 
分の 色 を ライ ン毎 にかえる こ とが 可能です. この ルーチン はス クリーン. 4 から 8 でのみ 有効です • 
その他の モー ド では ス プライ ト色は 次の putspr で 一色の みの 指定が 可能です. スクリーン 0 から 
3 に対して 実行され た 場合の 動作 は 保証され ません. 

plane でス プライ ト面 番号 を 指定し， color に ライン 毎の 色， その他の データへの ポインタ を 与 
えます. 

color の データ はス プライ 卜の サイズに より S 初の 8 バイ ト または 16 バイ 卜が 有効と なり ま 
す， データが これに 満たない 場合 は 終わりの 方の ラインの 色 は 不定です. 
color データの 各 バイ ト は 具体的に 次の よう な 意味 を 持ち ます. 
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MSB LSB 
+ —— + 一十 一 + — + —— + — + — + — + 

EC CC IC 0 Color code 

実際に ス プライ トラインの 色と して 有効な の は， 下位の 4 ビット だけで， 上位の 3 ビットが 特 
に 次の ような 意味 を 持ちます. 

EC: 32 ビット 左 シフト を 1 = おこなう 

0 = おこなわない 
CC: 優先順位の 有無 1 = 優先順位 なし 

0 = 優先順位 有り 

IC: 衝突の 検出の 有無 1 = 検出し ない ^ 

0 - 検出す る 

ただし EC ビッ ト に関して は， putsprO で x 座標に 応じて 変更され ますので， この ビッ 卜 を 積極 
的に 使用す る 場合 は putsprO を 実行した 後 毎回 colsprO を 実行し なければ な り ません. 

EC,CC，IC の 各ビッ ト についての 詳細 は 「MSX2 テクニカル ハンドブック」 など を ご 参照 下さ 
レ\ 

VOI D putspr ^plane , x , y , color , pat) 
TINY plane, color, pat ； 
int x,y ； 

ス プライ ト を 表示し ます， 

plane 面に pat パターン を 割当て， 画面の （x,y) にス プライ 卜 面の 左上 端 を 置きます. また， ス 
クリーン 4 から 8 では colspr でス プライ トカラ 一 を 指定す るので， color は 意味が ありま せんが， 
省略 はでき ません. この場合 color に は 任意の ダミーの 値 をセッ ト して 呼び出して 下さい. この 命 ^ 
令の み int で 座標 を 指定し ます. 座標の 範囲 は— 32 から 255 となり ます. 

x, y の 値 は 自動的に， cjastx, cjasty に 代入され ます. 

3.4,8 ビット ブロック 転送 

ビ ッ 卜 ブロッ ク 転送 関数 は MSX-BASIC の COPY 命令に 相当す る ものです. スクリーン 5 から 
8 までで 有効です. 

VOID cpyv2v (sxl.syl f sx2, sy2 ,sp,dx,dy,dp, logop) 
NAT sxl,syl,sx2,sy2 ； 
TINY sp ； 
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NAT dx'dy ； 
TINY dp ； 
TINY logop ； 

VRAM のべ一 ジ sp の （sxl ,syl) か ら （sx2 , sy2) の 領域 を， ページ dp の （dx , dy) へ 転送 します. 
dx, dy の 値 は 自動的に， c 一 lasbc, c_lasty に 代入され ます. 

VOI D cpyv2m (sx 1 , sy 1 , sx2 , sy2 , sp , dest) 
NAT sxl / syl,sx2,sy2 ； 
TINY sp ； 
TINY *dest ； 

VRAM の ページ sp の （sxl ,syl) か ら （sx2 ， sy2) の 領域 を， dest で ポイント される メイン RAM 
に 転送し ます， dest の 先頭 2 ワードに は x 方向， y 方向の ドッ ト数 （それぞれ sx2— sxl + l， sy2- 
syl + 1) が この 順に 設定され， その後に 実際の データが 続く ように 設定され ます， 

sx2， sy2 の 値 は 自動的に， cjastx, cjasty に 代入され ます. 

VOID cpym2v (src , dir , dx , dy , dp , logop) 

TINY ネ src ； 

TINY dir ； 

NAT dx,dy ； 

TINY dp ； 

TINY logop ； 

src で ボイ ント される メイン RATV1 の 画像 データ を， VRAM の ページ dp の （dx，dy) へ 転送し 
ます. 

転送す るデー タ は， 先頭 部分に 画像の x 方向， y 方向の ド ッ 卜 数の 情報 を 持つ ていなくて はな り 
ません. この 形式 を 持つ データと して は， 上の C py V 2m () によって VRAM か ら 転送 し た デ一 タ や 
BASIC の COPY 命令に よ り VRAM から フ アイ ルに コ ピーした データな どが あ り ま す， 

dir では 転送の 方向 を 指定 し ま す 力、 具体的な 指定 方法 は MSX- BASIC の COPY 命令と 同じ 
です ので， そちら を ご 参照 下さい. 

3.4.9 その他の グラフィック 関係の 関数 



VOID totextO 

スク リーン モ一 ドを 強制的に 以前の テキス 卜 モー ドに 戻します， テキス 卜 モー ドで この ルー チ 
ンを 実行しても 何もお こない ません. 
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引き数， 戻り 値 はあり ません. 



VOID grpprt (chjogop) 
char ch ； 
TINY logop ； 

グラフィック スクリーン に対して， cjastx, cjasty の 位置に 文字 ch を 表示し ます. 

ch は 1 バイ 卜の キャラクタ 一です. cjastx,c_lasty は 次の 文字の 位;！ を 示す ように 更新され 
ま す. logop で 口 ジ 力 ル才 ペレ 一ショ ンを 指定 します. スクリーン 2 から 4 では logop は 無視され 
ますが， 省略せ ずに 必ず TINY 型の 数値 を 指定して く ださい. 

スクリーン 2 から 4 では 文字の ド ッ 卜が オンに なって いる 部分の みが フォアグラウンド 色で 表 
示されます. スクリーン 5 から 8 では 文字の ドット が 才 ン になって いる 部分 は フ ォ ァ グラウン ド 
色に， オフに なって いる 部分 は バックグラウンド 色に なり， これに 対して 指定され た ロジカル ォ 
ペレ ーシ ヨンが 実行され 表示され ます. 

本 ルーチンで 漢字 を 表示す る こと はでき ません， 漢字の 出力に は 下の knjprtO を 使用して 下さ 
い. 

VOID knjprt (JIS_knj , logop , mode) 
NAT JIS 一 knj ； 
TINY logop ； 
TINY mode ； 

グラフ ィ ック スクリーン に対して， c— lastx,cjasty の 位 H に， JIS— knj であた えた JIS 漢字 コ 
一 ドに 対応す る 文字 を mode で 示す 表示 モー ドで 表示し ます. 

本命 令 は スクリーン 5 から 8 に対して のみ 使用で きます. c_lastx,c_lasty は 次の 文字の 位置 を 
示す ように 更新され ます. logop で ロジカル オペレーション を 指定し ます. -- 

文字の ドッ 卜が オンに なって いる 部分 は フォアグラウンド 色に， オフに なって いる 部分 はバッ ^ 
ク グ ラウンド 色に なり， これに 対して 指定され た ロジカル オペレーション が 実行 さ れ 表示 さ れ ま 
す. 

mode に関して は， 以下の ような 3 種類の 表示 モー ドが 有効です， 



mode 


モードの 内容 


0 


16X16 


1 


偶数 番目の ドッ 卜 を 表示 


2 


奇数 番 H のドッ トを 表示 



VOID glocateU.y) 
NAT x.y ； 
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cjastx, cjasty に それぞれ x, y を 代入し ます. 

VOID setpg (dsppag , actpag) 
TINY dsppag, actpag ； 

VRAM の 表示 ページと 書き込み ページの 設定 を 行います. dsppag に 表示 ページ 番号， actpag 
に アクティブ ページ を 指定し ます. 戻り 値はありません. 

無効な ページ 番号 を 指定した とか， MSX 上で 実行した 場合の 動作 は 保証され ません. 実際に 切 
り 替え 可能な ベー ジ は 以下の と お り です. 



画面 モー ド 


VRAM64K マシン 


VRAM128K マシン 


5 


0 から 1 ベ一 ジ 


0 から 3 ページ 


6 


0 から 1 ベー ジ 


0 から 3 ページ 


7 


使用 不能 


0 から 1 ページ 


8 


使用 不能 


0 力、 ら 1 ページ 



I 使用例 I 

♦include <sidio.h> 
# include <g1 i b.h> 

/* 表示 ページの み を 1 に 変更し， アクティブ ページ は 変えない */ 

VOID funcK) 

{ 

setpg((TINY)l, c apagtO; 

} 



NAT vramsizeO 

VRAM の サイズ を 返す 関数です. 今の所 MSX なら 16 を， VRAM64K の MSX2 なら 64 を 
VRAM128K の MSX2 な ら 128 を 返します. 



I 使用例 I 

# include <$tdi o.h> 
# include <g 1 i b . h> 

/* VRAM サイズの チェック *Z 

VOID chk sizeO 

{ 

if (vramsizeO < 128) { 

printf ("I need at least 128K bytes of VRAM to run¥n，，〉; 
exit(l); 



第 4 章 数値 演算 関数 パッケージ 



4.1 数値 演算 関数 パッケージの 概要 

現在の MSX- C によって サポート される 数値 型 は 整数 型 と 文字 型の み となって います. しか 
し， 本格的な MSX-DOS 上での ュ 一ティ リ ティの 作成 や一 般 的な プログラムの 高速 化の ために 
MSX- C を 利用す る 場合に は， や は り 5 桁 以上の 有効 桁 数 や 浮動 小数に よ る 演算が 必要 となって 
きます. それ を C 言語に よって 実現しょう とすると， 手 問 や ソースコードが 急激に 増大して しま 
い， 実現 を あきらめたり， 他の 処理 系で 行う ことにな つてし まいました. そのような こと を プロ 
グ ラ ム作成 者が 意識せ ずに あたかも 新 しい 数値 型が あ るよう にサ ポー ト する ための も のが 数値 演 
算 関数 パッケージです. 

数値 演算 関数 パッケージ では 4 バイ ト 整数 型 (Long 型） と MSX-BAS1C とおな じ 倍精度 実数 
型 (double 型) の 2 種類 をサ ポー ト しています. 

4 バイ ト 整数 型 は 整数 型の 倍の 有効 桁 数 (9 桁) です ので 大抵の ユー ティ リ ティ はこれ で 十分で 
しょう， サポート される 演算 は 四 則， 剰余， 比較， 論理演算， シフト • 口 一ティトです， 

もう 一つの 型， 倍精度 実数 型 は 唯一の 実数 型で， 演算 は 有効 桁 数 14 桁の BCD によって 行われ 
ます. サポート される 演算 • 関数 は 四 則， べき 乗， 三角 閬数， 指数' 対数関数 などです， 

以上の 他に 従来の 整数 型との 変換 関数 や， 4 バイ 卜 整数 型と 倍精度 実数 型の 変換 関数が 用意 さ 
れて いま す. ま た， 新た に 供給 さ れた 関数の 他に 書式 付き 入出力 関数 (scanf 0 .printfO な ど) が 4 
バイ 卜 整数 型と 倍精度 実数 型の 入出力の ために 拡張され ています. . 



4.S 数値 演算 関数 パッケージの 使用法 

数値 演算 関数 パ ッ ケージ を 利用す る に は 専用のへ ッ ダフ アイ ル (math. h) を プロ グラムの 先頭 
でィ ン クルー ド しなければ な りません. 普通 は 標準へ ッ ダフ アイ ル (sklio.h) の 次で ィ ン クルー ド 
します. だいたい 次のようになります. 

^include <stdio.h> 
# include <math.h> 

/* 1 度の ラジアン を 計算 */ 
mainO 
{ 

XDOUBLE pi, kl80; 
XDOUBLE deg; 



36 



第 4 章 数 flft 演算 関数 パッケージ 



atoxd(Xpi, "3*1415926536"〉; 
atoxd(Skl80, "180"); 

xddiv(&deg, &pi, Xkl80); /* deg = pi/180; */ 
printf( M l deg = %f radYn", Sdcg); 

} 

ヘッダ を 読み込めば あと は， 従来 どおりの コー ディ ング がで きます. コンパイル 'リ ンク 手順に 
ついては， 本 パッケージの 他の モジュールと 同様に 行えます. 



4.3 各 数値 型の 詳細 

ここで は 4 バイ ト 整数 型 (以下 Long 型） と 倍精度 実数 型の それぞれ について 詳細 を 示します. 

4-3.1 型の 定義 



A) Long 型の 定藹 

Long 型 は 符号 付き Long 型の 1 種類で 符号無し Long 型 は 存在し ません. しかし， 入出力に お 
いて サポート されて いま すので 少 し 注意す る こ と で 符号 無 し Long 型の よう に 扱え ます， （こ れに 
ついては 「4.3.3 定数 代入 関数」， 「4.3.7 書式 付き 入出力 関数の 拡張」 を 参照して 下さい •） 符 
号 付き Long 型の 定義 は 次のように なり ます. 

使用す る 領域 は 4 バイ トで， 1 バイ ト目を 値の 最下位， 4 バイ ト目を 値の 最上 位と します. 符号 
は 4 バイ 卜 目の 第 7 ビッ ト とし， 2 の 補数 表現と します. MSX-C 上で は， 次のように 型 を 定義し 
ています. （この 型の 定義 は 数値 演算 関数 パッケージの ヘッダ ファイル math. h に 含まれて いま 



typedef struct { 

char byte[4]; 

} slong; 



B) 倍精度 実麵の 定義 

倍精度 実数 型 は MSX-BAS1C で 使用され る BCD 表現の 倍精度 実数と 同じ ものです， 詳しく 
は， MSX-BASIC の リファレンス マニュアル を ご覧 下さい. 倍精度 実数 型の 定義 は 次のようにな 
り ます， 

使用す る 領域 は 8 バイトで， 1 バイト 目 を 符号 （ビット 7) と 指数部 （ビット 0 から 6), 2 バイト 
目から 8 バイ ト目を 仮数部 1 桁 目から 14 桁 目までと して 使用して います. MSX- C 上で は， 次の 
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ように 型 を 定義して います. （この 型の 定義 は 数値 演算 関数 パッケージの ヘッダ ファイルに 含まれ 
ています.） 

typedef struct { 

char byte[8]; 

} x double; 



4.3,g 変数の 宣言 

Long 型 や 倍精度 実数 型の 変数 を 使用す る 場合に は， 他の 型と 同じ様に 使用す る 前に 宣言す る 
必要が あります. 宣言 は 次のように します. 

リ 

SLONG I ； 
XDOUBLE d; 

変数の 初期化 は， 外部 変数 または 静的 変数の 場合 可能です. 次のように キャラクタ 型の 配列と 
して 初期化 をし ます. （これにつ いての もう 少し 詳しい 説明が 4.6.2 B) にあり ますので そちら も 
ご覧 下さい •） 





SLONG 1 


= {0x78, 


0x56, 


0x34, 


0x12}； /* 外部 変数のと き 


*/ 


static 


SLONG fii 


= {10， 


20, 


30, 


40}； /* 静的 変数のと き 


*/ 




XOOUBLE d 


= {0x46, 


0x12, 


0x34, 


0x56, 0x78, 0x90, 0x12, 0x34}； 














/* 外部 変数のと き 


*/ 


static 


XDOUBLE e 


= {0x43, 


0x10， 


0, 0， 


0, 0, 0, 0}； /* 静的 変数のと き 


*/ 



Long 型 変数 1 は 16 進数で】 2345678 を 表し， m は 10 進数で 673059850 を 表します， また， 倍 
精度 実数 型 変数 d は 123456.78901234 を 表し， e は 100 を 表します. 

ソ 

4,3,3 定数 代入 関数 

10 進 定数 を Long 型 変数 や 倍精度 実数 梨 変数に 代入す るに は， 定数 代入 関数 を 使って 文字列 を 
数値に 変換し ます. 

SL0NC 1 ； 
XOOUBLE d; 

atosl(&l, "4980205")； 
atoxd(&d, "498.0205"〉; 

こ の よ う に する こと で Long 型 変数 I に は 10 進数で 4980205 という 数値が 代入 さ れ， 倍精度 実数 
型 変数 d に は 498.0205 という 数値が 代入され ます. このと き atosl() 関数 は オーバーフロー を 無 
視す るので 符号無し Long 型と して 代入す る こと もで きます. また， 10 進数 以外の 定数で 代入し 
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たい 場合に は， sscanfO 関数で 実現で きます. 

4,3-4 変数から 変数への 代入 

変数から 変数への 代入 は， Long 型 どうしゃ 倍精度 実数 型 どう しでない と 行えません. 型が 違う 
場合 は 変換 関数 を 使用す る 必要が あります. （変換 関数に ついては 「4.3.8 変換 関数」 を 参照し 
て 下さい *) 



SLONG I , m; 
XDOUBLE d, e; 
slcpy(&l, &m); 
xdcpy(8d, &e); 



4.3,5 演算 関数 



/* 1 = m ； Long 型の 場合 */ 
Z* d = e: 倍精度 実数 型の 場合 */ 



演算 関数と は， 何 か バラ メータ を 与える と 演算 結果 を 返す もの を 指します. この場合， 四則演 
算も 演算 関数に 含まれます. 演算 結果 は ユーザに よって 指定され た 領域に 格納され， 関数 値と し 
て は 返されません， 関数 値 として は Long 型の 場合 は 演算 結果への ポインタ が， 倍精度 実数 型の 場 
合 は 演算 結果の 状態が STATUS 型で 返 されます， 

オーバーフロー などの 演算 結果に ついて Long 型 は エラー 情報 を 返しません ので 注意して 下さ 
い. しか し 倍精度 実数 型 について は エラー が 発生 し た か ど う か を （0K ま た は ERROR で) 返し ま 
すから， 必要で あれば チヱ ックを 行って 下さい. 



SLONG I, m， n; 
XDOUBLE d, e, f; 

ノ * 何 か 別の 処理 */ 
sladdC&l, &m, Sn); /* 1 = m -h n ； Long 型で 和 を 求める. */ 

/* d 二 e * f ； 倍精度 実数 型で 積 を 求める， */ 
if(xdmuK&d， &e, &f) == ERROR) { 

f printf(stderr, "Math pack errorVn ,t ); 
exit(l); 

} 



パラメータの 説明 をし ましょう. 第 1 パラメータ は， 演算 結果 を 返す 変数への ポインタです. 
第 2 バラ メータ， それから あれば 第 3 パラメータ は 演算の 対象と なる 変数への ポインタです. こ 
れらの バラ メータの 順 は， 式で 表現した 場合と 同じよう になって います. また， 第 3 バラ メータ 
は 整数 を 指定す る 関数 もあります ので 注意して 下さい. 

パラメータの 変数 どう しが 重なって いても 正常に 動作し ますので， 不要な 変数 を 持つ 必要が あ 
りません. つまり， sladd(&l,&l,&0 ； とする ことで Long 型 変数 1 は 2 倍に なり， xdsub (& 
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d,&d，&d〉 ； とする ことで， 倍精度 実数 型 変数 d は 0 に 初期化す る ことができます „ 

2 つの 型のう ち， Long 型の 演算 関数 は ほとんどが 演算 結果への ボイ ンタを 返す ので 次の よう な 
ことができます. 

SLONG a, b， c; 

slmuK&c, atol(£a, "9938"), at.()l(&b, 11 3 985"))； 

この 記述 は c=(a = 9938)*(b = 1985) ； と 同じ こと を Long 型で 行います. 

4.3,6 比較 関数 

比較 閲数 は， 〗 つの 変数 値と ゼロ または 2 つの 変数 値 を Jt 較 して その 結果 を 整数 値の- 1,0,1 の 
どれ かで 返す ものです ノ マラ メータ は Long 型 か 倍精度 実数 型への ボイ ンタ で, 関数 値 は 整数 型で 
す. 関数 値が 整数です ので 条件 式の 必要な 場所に 直接 記述す る ことができます. 

SLONG 1, m; 
X00UBLE d; 

♦ •• /* 何 か 別の 処理 *Z 

if(slcmp(81, &m) > 0) { 

/* 1 > m のとき の 処理 *ノ 

} else { 

/* 1 く = m のとき の 処理 *Z 

} 

whi )e(xdsgn(d) > 0) { 

/* d > 0 のとき の 処理 * ノ 

} 



4.3.7 書式 付き 入出力 関数の 拡張 



A) Long 型の Sst 付き 入出力に ついて 

Long 型 を 書式 付 きで 入力す る に は scanf ( ) 1« 数 中で， int 型 を 入力す るた めの ％ d の 代わ り に 

%ld を指定します.他の％乂，％0，％11 も同様に％ほ，％10，％出,と指定することができます.格 

納先を 示す 弓 I き 数 は int 型な どと 同じで Long 型への ポインタ を 指定し ます， 

Long 型 を 式 付きで 出力す るに は printfO 関数 中で， int 型 を 出力す るた めの ％ d の 代わ り に 
%ld を 指定し ます. 他の ％x,%o，％u も 同様にで きます. また， 対応す る 値に は 変数 そのもの 
ではなく， Long 型 変数への ポインタ を 渡します. 
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I nt I y 

SLONG I ； 

scanf( w Xd %\6 9 \ &i, &0； 
printf( w integer:%d long:Xld¥n", i , 51)； 



B) fSB 度 実 の 書式 付 さ 入出力に ついて 

倍精度 実数 型 を 書式 付きで 入力す るに は scan f() 関数 中で， int 型 を 入力す るた めの ％ d の 代わ 
りに ％f または ％e を 指定し ます. %f, %e どちら を 指定した 場合に も 固定 小数点， 浮動小数点 
の 両方の 方式で 入力す る ことができます. ただし， 空白で 区切る という 制限が あります ので 注意 
して 下さい. 格納 先 を 示す 引き数 は int 型な どのと きと 同じで 倍精度 実数 型への ポィ ンタを 指定 
します， 

倍精度 実数 型 を 式 付きで 出力す るに は printfO 関数 中で， hit 型 を 出力す るた めの ％d の 代わ 
りに ％ f または ％ e を 指定し ます. ％ f が 指定 さ れた 場合に は 固定 小数点 方式で， % e が 指定 さ れ 
た 場合に は 浮動小数点 方式で 表示され ます. また， 対応す る 値に は 変数 そのもの ではなく， 倍 精 
度 実数 型 変数への ボイ ンタを 渡します. 

int i ； 
X DOUBLE f ； 

scanfC'Xd %f 9 \ &f); 
printf("inte^er:Xd double:Xf Yn"， i, Sf); 

A) ， B) と 従来の 型 を まとめる と 使用可能な も の は 次の よ う な 表に なります. 





scanf 0 


printf 0 


int 


%d,%x,%o 


%d,%X，％0 


unsigned 


%u,%x,%o 


%u,%x，％o 


char 


%c 


%c 


string ichar *) 


%s 


%s 


long(SLONG) 


%ld,%lx,%lo 


%\d t %\x,%\o 


unsigned long 
(SLONG 入出力の み） 


%lu,%Ix,%lo 


%lu，％lx,%lo 


double (XDOUBLE) 


%f,%e 


%f,%e 
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4,3,8 変換 関数 

変換 関数 は 頻度の 高い 型変換 を 直接 行うた めの 関数です. ですから， ある 型から ある 型への 変 
換 関数が 必ず 存在す る わけではありません. また， 定数 代入 関数 も 変換 関数の 一部と 考える こと 
がで きます， 

下の 表で は scanf(),printf() を 含めて 1M 数で 変換 可能な もの， 変換 不要な もの を 示します. 



表 変換 可能な 型 

(関数 または = のとき 直接 変換 可能， No のとき 直接 変換 不可能) 



\^st type 
src type 


int 


unsigned 


char 


string 


long 


unsigned 
long 


double 


int 








sprintf 0 


itoslO 


No 


itoxdO 


unsigned 








sprintf 0 


uitoslO 


uitoslO 


No 


char 








sprintf 0 


No 


No 


No 


string (char *) 


atoiO 


atoi 0 




strcpy 0 


atoslO 


atoslO 


atoxdO 


long(SLONG) 


No 


No 


No 


sprintf 0 


slcpyO 


slcpyO 


sltoxdO 


unsigned long 


No 


No 


No 


sprintf () 


slcpyO 


slcpyO 


ultoxdO 


double 
(XDOUBLE) 


xdtoi 0 


No 


No 


sprintf 0 


xdtoslO 


No 


xdcpyO 



「=」 が ある 変換 は 直接 代入 または キャスト によって 変換で きます. 関数 名が ある 変換 は その 

関数に よって 変換が でき ます. 「No」 と 表示され ている ものに 関して は 1 度 sprintfO でス トリン 
グに 変換して から， sscanfO や 定数 代入 関数 を 使って 再度 変換す る ことで 実現で きます. また， 長 
さが 違います が 内部 表現が 同じで ある long から int や unsigned への 変換 は キャス ト を 使う こ と 
でで きます. （例 ： i=*(int *)&| ； ) 



4.4 数値 演算 関数 一覧 



定数 代入 関数 


関数 名 


用 途 


参照 ページ 


atosl 


数値 を 表す 文字列 を Long 型に 変換 


45 


atoxd 




数値 を 表す 文字列 を 倍精度 型 変数に 変換 


45 
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変数から 変数への 代入 



関数 名 


m 途 


参照べ- 


-ジ 


slcpy 


Long 型の 値 を Long 型の 変数に 代入 




45 


xdcpy 


倍精度 実数 型の 値 を 倍精度 実数 型の 変数に 代入 
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演算 関数 A) Long 型の 演算 関数 


関数 名 


用 途 


参照べ、 


ージ 


sladd 


Long 型 どう しの 加算 




46 


slsub 


Long 型 どう しの 減算 




46 


slmul 


Long 型 どうしの 乗算 




46 


sldiv 


Long 型 どう しの 除算 (符号つ き） 




46 


slmod 


Long 型 ど う し の 剰余 算 (符号つ き ） 




46 


uidiv 


Long 型 どう しの 除算 (符号な し） 




47 


ulmod 


Long 型 どう しの 剰余 算 (符号な し） 




47 


slneg 


Long 型の 数値に- 1 を かけた もの を 返す 




47 


slabs 


Long 型の 絶対値 を 返す 




47 


slnot 


Long 型 をビッ ト ごとに 反転させる 




47 


sland 


し ong 型で ビッ 卜 ごとの 論理 積 を 求める 




47 


slor 


Long 型で ビ ッ ト ご と の 論理和 を 求め る 




48 


slxor 


Long 型で ビッ ト ごとの 排他的 論理和 を 求める 




48 


slsla 


Long 型 を 算術 的 左シフ 卜 行う 




48 


slsll 


Long 型 を 論理的 左シフ ト 行う 




48 


slsra 


Long 型 を 算術 的 右シフ 卜 行う 




48 


slsrl 


Long 型 を 論理的 右シフ 卜 行う 




49 


slrlc 


Long 型 を 左 ローティ ト ザ亍 う 




49 


slrl 


n 




49 


slrrc 


Long 型 を 右 ローティ ト 行う 




49 


slrr 


〃 
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B) 倍精度 実数 型の 演算 関数 


閲 数名 


用 途 


参照 ぺ、 


-ジ 


xdadd 


倍精度 実数 型 どうしの 加算 




50 


xdsub 


倍精度 実数 型 どうしの 減算 




50 


xdmul 


倍精度 実数 型 どうしの 乗算 




50 


xddiv 


倍精度 実数 型 どう しの 除算 




50 


xdpow 


倍精度 実数 型 どう しのべき 乗 を 計算す る 




51 
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関数 名 


用 途 


参照べ、 


ージ 


xdneg 


数値に-] を かけた もの を 返す 




51 


xdfabs 


数値の 絶対値 を 求める 




51 


xdfix 


数値の 小数 部分 を 切り捨てる 




51 


xdfloor 


数値 を 越えない 最大の 整数 を 求める 




51 


xdceil 


数値よ り 小さ く ない 最小の 整数 を 求める 




51 


xdsqrt 


倍精度 実数 型で 平方根 を 計算す る 




52 


xdsin 


数値 を ラジアン として 正弦 (サイ ン） を計箅 する 




52 


xdcos 


数値 を ラジアン として 余弦 （コ サイン） を 計算す る 




52 


xdtan 


数値 を ラジアンと して 正接 （タ ンジヱ ント） を 計算す る 




52 


xdatn 


数値の 逆 正接 （ァ一 クタ ンジ ヱン 卜） を 計算す る 




52 


xdlog 


数値の 対数 を 計算す る 




52 


xdexp 


e に対する 指数 を 計算す る 




52 


xdrnd 


乱数 を 発生させる 




53 


比較 関数 


関数 名 


用 途 


参照べ、 


—ジ 


slsgn 


Long 型の 符号 値 を 返す 




53 


slcmp 


Long 型 ど う し で 比較し 結果 を 返す 




53 


xdsgn 


倍精度 実数の 符号 値 を 返す 




53 


xdcmp 


倍精度 実数 型 どう しで 比較し 結果 を 返す 




54 


変換 関数 


関数 名 


用 途 


参照べ 


ージ 


sltoa 


Long 型の 数値 を 文字列に 変換す る 




54 


itosl 


整数から Long 型に 変換す る 




54 


uitosl 


符号な し 整数から Long 型に 変換す る 




54 


xdtoa 


倍精度 実数 型 を 文字列に 変換す る 




54 


itoxd 


整数 型から 倍精度 実数 型に 変換す る 




55 


xdtoi 


倍精度 実数 塑 か ら 整数 型 に 変換す る 




55 


sltoxd 


Long 型 か ら 倍精度 実数 型 に 変換す る 




55 


ultoxd 


Long 型の 他: を 符号な し と して 倍精度 実数 型に 変換す る 




55 


xdtosl 


倍精度 実数 型 を L(mg 型に 変換す る 
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4.5 数値 演算 関数 リファレンス 



4.5.1 定数 代入 関数 



SLONG *atosl (ans.s) 
SLONG *ans ； 
char *s ； 

数値 を 表す 文字列 を 変換して Long 型 変数に 代入 します. 関数 値 として は， 第 1 バラ メータと 同 
じ ものが 返されます. 

STATUS atoxd(ans,s) 
XDOUBLE *ans ； 
char *s ； 

数値 を 表す 文字列 を 変換して 倍精度 実数 型 変数に 代入し ます. M 数値と して は， 変換が 成功し 
たかの ステータス が 返 されます， 

4.5-2 変数から 変数への 代入 



SLONG *slcpy(ans,pl) 
SLONG *ans, *pl ； 

pi で 示される Long 型 変数の 値が ans で 示される Long 型の 変数に 代入され ます. つま り 
*ans = *pl ； なること を Long 型で 行い ま す. 

XDOUBLE *xdcpy(ans,pl) 
XDOUBLE *ans, *pl ； 

pi で 示 される 倍精度 実数 型の 値が ans で 示さ れる 倍精度 実数 型の 変数に 代入 されます. 

4.5.3 演算 関数 

A) Long 型の 演算 関数 
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SLONG *sladd(ans / pl / p2) 
SLONG *ans, *pl, *p2 ； 



Long 型 どう しで 加算 を 行います. つま り， *ans=*pl+*p2 ； なる 計算 を Long 型で 行い ま 
す. 

SLONG *slsub(ans,pl,p2) 
SLONG *ans, *pl, *p2 ； 

Long 型 どうしで 減算 を 行います. つまり， *ans=*pl— *p2: なる 計算 を Long 型で 行い ま 
す， 

SLONG *slmul(ans,pl,p2) 
SLONG *ans, *pl, *p2 ； 

Long 型 どうしで 乗算 を 行います. つまり， *ans=*pl * *p2 ； なる 計算 を Long 型で 行い ま 
す. 

SLONG *sldiv(ans,pl,p2) 
SLONG 本 ans, *pl, *p2 ； 

Long 型 どうし で 除算 を行レ ほす. つまり， *ans 二 *pl ノ * p2 ； な る 計算 を Long 型で 行レ ^ ま 
す. この 関数 は 符号つ き Long 型 を 想定して います. 

SLONG *slmod (ans ,pl,p2) 
SLONG *ans, *pl, *p2 ； 

Long 型 どうしの 剰余 を 計算し ます. つまり， *ans=*pl%*p2: なる 計算 を Long 型で 行い 
ます. この 関数 は 符号つ き Long 型 を 想定して います， 

SLONG *uldiv(ans,pl,p2) 
SLONG *ans, *pl, *p2 ； 

Long 型 どうしで 除算 を 行います • つまり， *ans=*plZ*p2: なる 計算 を Long 型で 行い ま 
す. この 関数 は 符号無し Long 型 を 想定して います. 

SLONG *ulmod(ans,pl,p2) 
SLONG *ans, *pl, *p2 ； 
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Long 型 どうしの 剰余 を 計算し ます. つまり， *ans=*pl%*p2: なる 計算 を Long 型で 行い 
ます， この 関数 は 符号無し Long 型 を 想定して います. 

SLONG *slneg(ans,pl) 
SLONG *ans, *pl ； 

Long 型の 数値に 一 1 を かけた もの を ans に 返します. *ans=-*pl ： と 同じ 事 を Long 型で 
行います. 数値が マイナスの 最大値 一 2147483648 であった 場合に は 変化が ありません. ans と pi 
が 同 じであった 場合 は， 指定 さ れた 変数の 値に 一 1 がかけ られ ます. 

SLONG *slabs(ans,pl) 
SLONG *ans, *pl ； 

Long 型の 絶対値 を ans に 返します. *ans=abs( *pl) ； と 同じ 事 を Long 型で 行います. 数 
値が マイナスの 最大値— 2147483648 であった 場合に は 変化が あり ません. 

SLONG *slnot(ans,pl) 
SLONG *ans, *pl ； 

Long 型 をビッ ト ごとに 反転させます. つまり， *ans=〜*pl ； なる 計 @ を Long 型で 行い ま 
す. 

SLONG *sland (ans , pi , p2) 
SLONG *ans, *pl, *p2 ； 

Long 型で ビッ 卜 ごとの 論理 積 を 求めます. つまり， *ans 二 *pl&*p2 ； なる 計算 を Long 型 
で 行います. 

SLONG *slor(ans,pl / p2) 
SLONG *ans, *pl, *p2 ； 

Long 型で ビッ ト ごとの 論理和 を 求めます. つまり， *ans= *pl ！ * P 2 ； なる 計算 を Long 型 
で 行います. 

SLONG *slxor (ans , p 1 , p2) 
SLONG *ans, *pl, *p2 ； 

Long 型で ビッ ト ごとの 排他的 論理和 を 求めます. つま り， * ans = *pl へ * p2 ； なる 計算 を 

4フ 



Long 型で 行います. 



SLONG *slsla(ans,pl,k) 
SLONG *ans, *pl ； 
TINY k ； 



Long 型 を k ビッ ト 算術 的 左シフ 卜 行います， つまり， *ans=*pl くく k ； なる 計算 を Long 
型で 行います. 最後に 追い出された ビッ トは BOOL slcy に 格納され ます. この 関数 は オーバ一 フ 
ロー を 考えません. 



slcy ― —31 



*pl 



0 



SLONG *slsll(ams,pl,k) 
SLONG *ans, *pl ； 
TINY k ； 



Long 型 を k ビッ ト 論理的 左シフ ト 行います. つまり， *ans=*pl « k ； なる 計算 を Long 
型で 行います. 最後に 追い出された ビット は BOOL slcy に 格納され ます. この 関数 は slslaO と 
全く 同じ 動作 をし ます， 



slcy 



31 



J2L 



0 



0 



SLONG *slsra(ans,pl,k) 
SLONG *ans, *pl ； 
TINY k ； 



Long 型 を k ビッ ト 算術 的 右シフ ト 行います. つまり， 符号 ビッ 卜 を 保存しながら *ans=*pl》 
k ； なる 計算 を Long 型で 行います. 最後に 追い出された ビッ トは BOOL slcy に 格納され ま 
す. この 関数 は オーバーフロー を 考えません. 



31 



*d1 



slcy 



SLONG *slsrl(ans,pl,k) 
SLONG *ans,*pl; 
TINY k ； 



Long 型 を k ビッ ト 論理的 右 シフト 行います. つまり， *ans=*pl〉>k: なる 計算 を Long 型 
で 行います ♦ 最後に 追い出された ビッ トは BOOL slcy に 格納され ます. 
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31 



*pl 



slcy 



SLONG *slrlc(ans,pl,k) 
SLONG *ans, *pl ； 
TINY k ； 

Long 型 を k ビッ ト左 ローティ トを 行います， ビッ ト 31 から 追い出された ビッ ト はビッ ト 0 に 
移り ます. 最後に 追い出された ビッ ト 31 は BOOL slcy に 格納され ます. 



slcy 



31 



J 



SLONG *slrl(ans,pl,k) 
SLONG *ans, *pl ； 
TINY k ； 

Long 型 を k ビッ ト左 ローティ トを 行います. ビッ 卜 31 から 追い出された ビッ トは BOOL 
slcy に 格納され， slcy はビッ ト 0 に 移ります. 最後に 追い出された ビッ ト 31 が BOOL slcy に 格 
納 されます. 



slcy 



31 



*pl 



J 



SLONG *slrrc(ans,pl,k) 
SLONG *ans, *pl ； 
TINY k ； 

Long 型 を k ビッ ト右 ローティ トを 行います ♦ ビッ ト 0 から 追い出された ビッ ト はビッ ト 31 に 
移り ます. 最後に 追い出された ビッ ト 0 は BOOL slcy に 格納され ます. 



31 



*pl 



slcy 



SLONG *slrr(ans / pl,k) 
SLONG 水 ans, *pl ； 
TINY k ； 



Long 型 を k ビッ ト右 ローティ トを 行います. ビッ ト 0 から 追い出された ビッ トは BOOL slcy 
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に 格納され， slcy はビッ ト 31 に 移り ます. 最後に 追い出された ビッ ト 0 力 s、BOOL slcy に 格納 さ 
れ ます， 



31 — *pl — — 0 」 — S lcy 



コ 



B) 倍精度 実数 型の 演算 関数 

STATUS xdadd(ans,pl,p2) 
XDOUBLE *ans, *pl, *p2 ； 

倍精度 実数 型 どう しの 加算 を 行います. つま り， *ans= *pl+*p2 ； なる 計算 を 倍精度 実数 型 
で 行います. 

STATUS xdsub(ans,pl,p2) 
XDOUBLE *ans, *pl, *p2 ； 

倍精度 実数 型 どう しの 減算 を 行います. つま り， *ans=*pl-*p2 ； なる 計算 を 倍精度 実数 型 
で 行います. 

STATUS xdmul(ans,pl,p2) 
XDOUBLE 氺 ans, *pl, *p2 ； 

倍精度 実数 型 どうしの 乗算 を 行います， つま り， * ans =*pl * *p2 ； なる 計算 を 倍精度 実数 
型で 行います. 

STATUS xddiv(ans,pl t p2) 
XDOUBLE *ans, *pl, *p2 ； 

倍精度 実数 型 どう しの 除算 を 行います. つま り， *ans=*pl/*p2 ； なる 計算 を 倍精度 実数 型 
で 行います. 

STATUS xdpow (ans , p 1 , p2) 
XDOUBLE *ans,*pl,*p2 ； 

倍精度 実数 型の べき 乗 を 計算し ます， つまり， *ans=pow(*pl,*p2) ； なる 計算 を 倍精度 実 
数 型で 行います. 

STATUS xdneg(ans,pl) 
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XDOUBLE *ans, *pl ； 

数値に— 1 を 掛けた もの を 返します. つま り， *ans= — *pl ； なる 計算 を 倍精度 実数 型で 行い 
ます. 

STATUS xdfabs(ans # pl) 
XDOUBLE *ans, *pl ； 

数値の 絶対値 を 求めます. つまり， *ans=fabs(*pl) ； なる 計算 を 倍精度 実数 型で 行い ま 
す. 

STATUS xdfix(ans'pl) 
XDOUBLE *ans, *pl ； 

数値の 小数 部分 を 切 り 捨て ま す. MSX-BASIC の FIX 関数 と 同 じ 事 を 倍精度 実数 型で 行い ま 
す. つまり， 数値の ゼロよりの 整数 を 求めます. 

STATUS xdfloor(ans,pl) 
XDOUBLE 氺 ans, *pl ； 

数値 を 超えない 最大の 整数 を 求めます. つまり， *ans=floor(*pl) ； なる 計算 を 倍精度 実数 
型で 行います. 

STATUS xdceil(ans,pl) 
XDOUBLE *ans, *pl ； 

数値より 小さ く ない 最小の 整数 を 求めます. つまり， * a ns=ceil(*pl) ； なる 計算 を 倍精度 実 
数 型で 行います. 

STATUS xdsqrt(ans,pl) 
XDOUBLE *ans, *pl ； 

倍精度 実数 型で 平方根 を 計算し ます. つまり， * anS =sqrt(*pl) ； なる 計算 を 倍精度 実数 型で 
行います， 

STATUS xdsin(ans.pl) 
XDOUBLE *ans, *pl ； 

数値 を ラジアン として 正弦 (サイン） を 計算し ます. つまり， * ans = S in(*pl) ； なる 計算 を 倍 
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STATUS xdcos (ans.pl) 
XDOUBLE *ans, *pl ； 

数値 を ラジアン として 余弦 （コ サイン） を 計算し ます. つまり， * ans = cos (*p】） ； なる 計算 を 
倍精度 実数 型で 行います. 

STATUS xdtan(ans,pl) 
XDOUBLE *ans, *pl ； 

数値 を ラジアン として 正接 （タン ジヱン 卜） を 計算し ます. つまり， *ans 二 tan(*pl) ： なる 計 
算を 倍精度 実数 型で 行います. 

STATUS xdatn (ans.pl) 
XDOUBLE *ans, *pl ； 

数値の 逆 正接 （アーク タンジュン ト） を 計算し ます. つまり， *ans=atan(*pl) ； なる 計算 を 
倍精度 実数 型で 行います. 

STATUS xdlog(ans,pl) 
XDOUBLE *ans, *pl ； 

数値の 対数 を 計算し ます. つまり， * ans =log(*pl) ： なる 計算 を 倍精度 実数 型で 行います. 

STATUS xdexp(ans,pl) 
XDOUBLE 氺 ans, *pl ； 

e に対する 指数 を 計算し ます. つまり， *ans=exp(*pl) ； なる 計算 を 倍精度 実数 型で 行い ま 
す. 

STATUS xdrnd(ans,pl) 
XDOUBLE *ans, *pl ； 

0 から 1 までの 乱数 を 得ます. *pl く 0 の 場合 は 乱数 系列の 初期化 を 行い， *pl = 0 の 場合 は 前 
回の 値 を 返し， *pl〉 0 の 場合 は 次の 乱数 を 発生 させ それ を 返します. 
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4.5.4 比較 関数 

int slsgn (pi) 

SLONG *pl ； 

指定され た Long 型の 符号 値 を 返します. 結果 は 下に 示します. 

slsgn 0 



int slcmp(pl / p2) 
SLONG *pl,*p2; 

Long 型 どうしで 比較 を 行い， その 結果 を 下に 示す ように 返します. 

slcmpO 



int xdsgn(pl) 
XDOUBLE *pl ； 



指定 さ れた 倍精度 実数の 符号 値 を 返します. 結果 は 下に 示し ま す. 



xdsgnO 



ら ら ら 

る もな 

o o o 

> II < 

p p P 

* * * 



、つ ら ら 

な^? な 



p p P 

* * ォ 



ら ら ら 

もな な 



* * * 



氺 
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char *sltoa(s, し radix) 
char *s ； 
SLONG *l ； 
TINY radix ； 

Long 型の 数値 を radix 進数と して 文字列 に 変換した もの を s で 示 される 領域 に 格納 し， s を 返 
します. radix のビッ ト 7 が 立って いる 場合に は 符号な しの 数値と して 扱います. 

SLONG *itosl(ans,i) 
SLONG *ans ； 
int i ； 

整数から Long 型に 変換し ます. このと き 符号の 拡張が 行われます. 

SLONG *uitosl(ans,ui) 
SLONG *ans ； 
unsigned ui ； 

符号無し 整数から Long 型に 変換し ます. もともと 符号はありません から， 拡張 は 行われ ませ 
ん. 

char *xdtoa \s f d t digits) 
char *s ； 
XDOUBLE *d ； 
TINY digits ； 



int xdcmp(pl / p2) 
XDOUBLE *pl,*p2 ； 

倍精度 実数 型 どう しで 比較 を 行い， その 結果 を 下に 示す ように 返します 

xdcmpO 

1 

0 

-1 

4.5.5 変換 関数 



ら ら ら 

もな な 



^^印 

一一 く 

，s 
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倍精度 実数 型の 数値 を 文字列 と して 変換した もの を s で 示される 領域に 格納 し， s を 返します. 
digits で 小数点 以下の 桁 数 を 指定し ます ♦ digits のビッ ト 7 が 立って いない 場合 は 固定 小数点 形 
式で， 立つ ている 場合 は 浮動小数点 形式に 変換 します. 

STATUS itoxd(dj) 
XDOUBLE *d ； 
int i ； 

整数 型 か ら 倍精度 実数 型 に 変換し ます. 

STATUS xdtoi(i,d) 
int *i ； 

XDOUBLE *d ； 

倍精度 実数 型から 整数 型に 変換し ます. 小数点 以下 は 切り捨てられ， 変換され た 数値が 整数の 
範囲 外で ある 場合に は 関数 値と して ERROR が 返されます. 

STATUS sltoxd(d / l) 
XDOUBLE *d ； 
SLONG *l ； 

Long 型から 倍精度 実数 型に 変換 します. 

STATUS ultoxd(d,ul) 
XDOUBLE *d ； 
SLONG *ul ； 

Long 型の 値 を 符号無し として 倍精度 実数 型に 変換し ます， 

STATUS xdtosl (し d) 
SLONG *1 ； 
XDOUBLE *d ； 

倍精度 実数 型 を Long 型に 変換し ます， 小数点 以下 は 切り捨てられます. 変換され た 数値が 
Long 型の 範囲 外で あ つても エラーが 返される ことはありません. 
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4.6 数値 演算 関数 を 使う 上での 注意点， 留意 点 



4,6,1 使用 上の 注意点 

A) 倍精度 実数 型 を 使用す る た め に は スタック 領域が ベ一 ジ 2 ま た は 3 に あ る 必要が あ ります 
(ス タ ッ ク 領域に Math-Pack を 呼び出す コー ド を 置 くた め）. 通常 ス タ ック 領域 は 指定の ぺー ジ 
にあり ますが， 自動 変数と して 非常に 大き な 配列 を 宣言す る と ページ 0 または 1 になる 場合が あ 
ります. 

B) Long 型で は 演算 や 変換 を 行っても その 結果の 範囲に ついての チヱ ック をし ません. これ は 
整数 型な どと 同じ です が， 倍精度 実数 型 か ら 変換す る 場合に は 事前に 範囲の チ x ック など をして 
不良 動作 をし ないように する こと をお 薦めし ます. 

C) 倍精度 実数 型 を アスキー 文字列と して 入出力す る 場合， その 一時 バッファ として BUF 
(0F55EH から 258 バイ 卜） と FBUFFER(0F7C5H 力、 ら 43 バイ ト） を 使用し ますので， この 領域 
を 使用 す る 場合に は 十分 ご注意 下 さい. 

4.6,2 テク ニッ鴻 

A) 数値 演算 関数 ノ 《ッケ 一 ジ を 使用 す る 場合に は ヘッダ ma th . h を インクルードし ますが， その 
中には scanfO ,printf() を 拡張する ための # define 文が あ り ます. これによ つて scanfO ,printf() 
が g き 換えられ ています. 拡張され ていない scanf(),printf() を 使用したい 場合に は, # include 
く! nath . h> 以降の 行で # undef printf などと してく ださい. な お この場合 も 拡張 さ れた scanf () ， 
print") は mscfO ,mprf() と して 使用す る こ とが 出来ます. 

#def ine pri nif mprf 
#def ine f printf inf prf 
#def ine spr i ntf msprf 
#def ine scanf mscf 
ftdef ine f scanf mfscf 
ltdef ine sscanf msscf 

(math.h よ り 抜粋） 

ま た， 本バ ッ ケージ ライ ブラ リファイ ルには Long 型, 倍精度 実数 型の 両方 を 一度に 利用す る こ 
とがで きる よ う に scanf () , printf 0 が 拡張 されて います. しかし， ソースファイル prs に c の # 
include く math . h> の 前で コ ンノ 《ィ ル スィッチ NOUSESL ま た は NOUSEXD を 定義 し， リコ ン 
パイ ル する こ とで Long 型， 倍精度 実数 型の それぞれ を 使わない ライ ブラ リ が 作成で きます. 新た 
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に 作成され た ライブラリ を 使用す る 場合に は， アプリケーションプログラム では， #include 
く math. h> の 前で コ ン パイル スィッチ NOUSESL または NOUSEXD を 定義し， リ ンク 時， 新た 
な ライ ブラ リをリ ンク する 必要が あり ます. 

\jrnl 倍精度 実数 型 を 使用し ない 例 



define N'OUSEXD /* 倍精度 実数 型 を 使用し ない 宣言 *Z 
ノ * この 行 を いれて コンパイルした prsc . c のリ ロケータ ブル オブジェ ク トモ ジュール 
も 必要です. 

必ず math . h の 前に いれて コンパイルして 下さい， 

Long 型 を 使用し ない 場合 は # define NOUSESL とする. 

*/ 

# include <math.h> 

main() 
{ 

} 

B) プログラムの 作成に は 初期化と いう もの は 重要な ものです. 初期化に は 定数 代入 関数 を 使用 
しても いいので すが， それ だと どうしても オブジェクト サイズが 大きくな つてし まいます. ここ 
で は Long 型 を 中心 に 別の 初期化 方法 について 紹介し ます. 

Long 型 を 0 に 初期化 し たい 場合に は キャスト を 利用 して 次のように すると 効率的です. 

*((int *)&longvar+l) = Hint わ JHongvar = 0； 

一 1 に 初期化したい 場合に は 0 の 代わり に— 1 を 指定 すれば できます. 

Long 型 を 0 に 初期化した 後 は char 型から ロングへの 変換が 簡単に でき ます， 

*((int *)ilongvar+1) = *(int Oilongvar = 0； 
longvar.byte[OJ - charvar; 

静的な （変数 宣言 時の） 初期化に ついても 述べ ま しょう. 変数の 宣言 時には 単なる 配列の よう に 
初期化が できます. 

SLONG longvar = {0x10, 0x27, 0， 0}； /* longvar= 10000 ； */ 

XD0UBLE dblvar = {0x43, 0x36, 0x52, 0x42, 0x20, 0, 0, 0}； 

ノ * dblvar = 365. 2422 ； */ 

Long 型の 初期化の た めの データ は MSX-BASIC で 次の ような プログラム を 実行 さ せれば 簡単 



5 フ 



に 作成で きます. 



100 A#=10000 ，求めたい 値 を 代入して おく 

110 FOR 1=1 TO 4 'Long 型 は 4 バイ ト 

120 PRINT A#-INT(A#/256)*256; 1 バイ トを 10 進数で 表示 

130 A#=INT(A#/256) ，次の バイ トの ための 準備 

140 NEXT 

倍精度 実数 型の 初期化の ための データ も 次のように できます 



100 A#=365.2422 

110 l=VARPTR(A#) 

120 FOR J=l TO 1+7 
130 PRINT PEFK(J); 
刚 NEXT 



'求めたい 値 を 代入して おく 
，格納 位 R を 求める 
'倍精度 実数 型 は 全部で 8 バイ 卜 
1 バイ トを 10 進数で 表示 



内部の 表現が わかって いる 場合に は 変数 宣言 時 以外に も， 各 型の メ ンバに 代入す る ことで 動的 
に 初期化が できます. 



/ * longvar = 10000 ； * / 
longvar.byte[0] = (char)OxlO; 
longvar.byie[l] = (char)0x27; 
*((int *)&longvar + 1) = 0； 



C) slbuf,slcy について 

数値 演算 関数/ ヤッケ一 ジ に は s ibuf , slcy という 外部 変数が 宣言 されて います. 

slbuf は一 時 的な 演算 結果の 格納に 使います. 使用す るに は 演算 関数な どの 結果 格納の 指定 (第 
1 パラメータ） に NULL ポィ ン タ を 指定 します. すると 関数 値 として slbuf への ポインタ が 返 さ 
れ ます. 演 @ 結果 は 使う がいつ まで もとって おく 必要がない 場合に 使う と 便利です. 例えば 

pri，itf("Xld¥n", si add (NULL, &a, ib)); 

とすれば 不要な 変数 を 宣言せ ずに Long 型 変数 a と b の 和 を 表示す る ことができます. NULL の 
代わりに ERROR を 指定しても 同様な ことができます. この場合 NULL と は 使用され る 領域が 
異なり ます. 

slcy はシフ 卜 'ローティ ト 関数 使用 時に キヤ リーフ ラグと して 動作し ます. つまり シフ 卜 や 口 
—ティ ト をした 後 変数から 追い出された ビッ 卜の 状態が この 変数に 入ります. ユーザ は 自由に こ 
の 変数 を 参照したり， 変更す る ことができます， ただし， slcy は BOOL 型 変数な ので YES また 
は NO のい ずれ かの 値し か 代入す る ことができません. また， 論理演算 関数 を 行っても NO にな 
る ことはありません. 

slbuf, slcy は どち ら も Long 型 専用の もので 倍精度 実数 型の M 数で は 使 ffl する こ と はでき ませ 
ん. 
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第 5 章 その他の 鬨数 



5.1 その他の 関数 要 

こ こで は 関数 を 以下の 3 つに 分類して その 概要 を 解説し ます. 

• スロット を 管理す る 関数 
• BIOS を 呼ぶ 関数 
• その他 

5- 1 • 1 スロッ 管理す る 関数 

スロッ ト間 での 関数 呼び出し をお こなったり， ROM-BIOS 内の ルーチン を コールす るた めの 
関数な どが 用意 されて います. 

これらの 関数 を 用いる 予備知識 としての MSX の スロット という 概念 や ， ROM-BIOS や ROM 
- BASIC などに ついては 「MSX2 テクニカル ハンドブック」 等 を ご 参照 下さい. 

5.1-g BIOS を 呼 /3 《関数 

MSX 本体に 内蔵され た ROM に は 数多 く の MSX の 基本的な 入出力 を 扱う ル一チ ンが 含まれ 
ています. これらの 入出力 ルーチン を 総称して BIOS (Bask I/O System) と 呼びます. 

アプリケーションプログラム では MSX の 各 機種 問での 差異 を 吸収す るた めに 入出力 はこの 
BIOS を 介して 行う ことが 推奨され ています. しかし， これまで は C の プログラム だけで BIOS ル 
一 チン を 呼び出す ために は 標準 ライ ブラ リ 関数の biosO や bioshO などの 汎用 的な 関数 を 用いる 
しかな く C プログラマに とって は BIOS-ROM 内の ルーチン を 積極的に 用いる こ とがで きる 環 
境で はあり ませんで した. そこで BIOS ルーチンの 中で も 必要性の 髙 いも の を 個別に C の 関数 呼 
び 出 しの 形で 用い る こと がで き るよう に したの が BIOS を 呼ぶ 関数 群です. 

BIOS ルーチンで ここ では サボ一 ト さ れ てない も の を 用いたい 場合 は 上の スロット を 管理す る 
関数の calbioO など を 用いる ことができます. 

5.1.3 その他の 関数 

その他に 乱数 を 発生す る 関数， MSX の バージョン を 獲得す る 関数， 割り込みめ 禁止， 許可 を 行 
う IW 数な どが あります. 
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5.E その他の 関数の 使用法 

本章で 解説す る 関数の 宣言 は msxbios . h のな かで 宜霄 されて います. ソースファイルの 中で ィ 
ンク ルードが 必要です. また， グラフィック 関数 を 併せて 用いる 場合で， glib. h の インクルード 
を 行つ て いる 場合に は こ のなかで msxbios . h の インク ルー ド がお こな われて いるた め， 格別に こ 
れをィ ンク ルードす る 必要 はあり ません. 

コンパイル は 通常 どおりに おこない， リ ンク 時には mlib.rel をリ ンク してく ださい. ノ 《ラメ一 
タ チェックに は mlib.tco を パラメータ として あたえます. コンパイル， パラメータ チェック， リ 
ン ク の 手順 は msxc . bat という バッチに まとめられ ています. 



5.3 その他の 関数 一覧 



スロッ トを 管理す る 関数 



関数 名 


用 途 


参照 ページ 


calbio 


ROM-BIOS の アドレス を コールす る 


62 


calbas 


}) 


62 


calsub 


SUB-ROM のァ ドレス を コールす る 


62 


calslt 


指定の スロッ 卜の ァ ドレス を コールす る 


63 


rdslt 


スロッ トのァ ドレスの 内容 を 返す 


63 


wrslt 


スロッ トのァ ドレスに データ を 書き込む 


63 


callx 


現在 表に でて いる スロッ トのァ ドレス を コールす る 
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n^n * の 付いた 関数 は 割 り 込み フラ グを 変化 させ ません. それ 以外の 関数 は 「割 り 込み 許可」 
で 返って き ます. 
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BIOS を 呼ぶ 関数 



関数 名 


用 途 


参照 ページ 


mi ink 


ファンク ショ ン キーの 内容 をデ フォルト に 戻す 


64 


disscr 


スク リーンの 表示の 禁止 


64 


レ i lclOV> 1 


スクリ ーンの 表示の 許可 


64 


o レ l レし 1 1 


スクリ ーン モー ドの 変更 


64 


gicini 


PSG の 初期 / [匕 


64 




PSG の レジスタに データ を 書 き 込む 


64 


1 お 


PSG の 指定され た レジスタの 内容 を 返す 


65 


chsns 


キー ボー ド か ら の 入力が あ る か ど う かの 判定 


65 


cht^et 
し 11 し 1 " 


キー ボー ド からの 一文字 入力 


65 


chput 


テキス 卜スク リーンへの 一文字 出力 


65 


lptout 


プリ ンタ への 一文字 出力 

, ノー Z 、ーノ J Z リ 


65 


lptstt 


プリ ンタの 準備が できて いるか どうかの 判定 


65 


pi ill iii 


スク リーン エディ タを 起動す る 


65 


inlin 


〃 


66 


break x 


Contro 卜 STOP が 押 されて いるか どう かの 判定 


66 


beep 


ビープ 音の 発生 

' •- • ^ ノ LJ ■■ 圍 , 


66 


els 


スク リー ンの 表示 を 消す 


66 


locate 


カー ソ ルの 位置 を 指定す る 


66 


prafnk 

レ l " 1 1 1 I v 


ファンク ショ ン キーの 表示^ 消す 


66 


dspfnk 


ファンク ショ ン キーの 表示 


66 


gtstck 


ジョイ ス ティ ックの 状態 を 調べる 


66 


gttrig 


ト リガ ボタンの 状態 を 調べる 


67 


gtpad 


入出力 装 匱の 状態 を 調べる 


67 


gtpdl 


パ ドルの 内容 を 読む 


68 


chgsnd * 


サウンド ポー ト のォ ン / ォ フ に よ る 音の 発生 


68 


snsmat 


キー マ ト リ クス の^ | を 見る 


69 


kilbuf 


キーボード バッファの 内容 を 消去す る 


69 



その他 



関数 名 


用 途 


参照 ページ 


rna * 


ランダムな 整数 を 返す 


69 


di 


割り込みの 禁止 


69 


ei 


割り込みの 許可 


69 


msx2 * 


MSX のバ一 ジョ ンを 調べる 


69 


fnkstr * 


ファンク ショ ン キーの 内容 を 保持して いる エリ マ（ 


、の ボイ ンタを 返す 
69 
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5.4 その他の 闋数 リファレンス 

本節の 解説で 用いられる 変数 型 は ヘッダー ファイル のなかで 次のように 定義され ています. 

TINY char 型に 定義 (typedef) さ れ てい ま す. 
NAT unsigned 型に 定義され ています. 



5,4,1 スロッ 管理す る 関数 

VOID calbio(adrs,reg) 
NAT adrs ； 
REGS *reg ； 

ROM-BIOS の 指定され た アドレス を コールし ます. ルーチン を コールす る 前に 値が ポインタ 
で 指定され たと ころから Z80 の レジスタに tr— ド され， ルーチンから リ ターンす る 際に Z80 のレ 
ジス タの 内容が 同じ 所に コピー されます. ROM- BIOS だけが. 表に 出ます. adrs は 0H から 
3FFFH の 間で なければ なり ません. 

REGS は msxbios . h の 中 で 以下の ように 定義され ています. 



typedef struct regs { 

TINY f ； 

TINY a; 

NAT be; 

NAT de; 

NAT hi; ソ 

} REGS; 



VOID calbas (adrs , reg) 
NAT adrs ； 
REGS *reg ； 

calbioO と ほぼ 同じです が， ROM-BIOS と BASIC- ROM の 両方が 表に 出ます. adrs は 4000H 
から 7FFFH の 間で なければ な り ません. 

VOID calsub (adrs, reg) 
NAT adrs ； 
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REGS *reg ； 

SUB-ROM の 指定され たァ ドレス を コールし ます. ルーチン を コールす る 前に 値が ポィ ンタで 
指定され たと ころから レジスタに ロードされ， ルーチンから リターン する 際に レジスタの 内容が 
同じ 所に コ ピーされ ます. SUB-ROM だけが 表に 出ます. adrs は 0H から 3FFFH の 問で なけれ 
ばな りません. 

VOI D calslt (slot , adrs , reg) 
TINY slot ； 
NAT adrs ； 
REGS *reg ； 

指定され た スロッ 卜の 指定され た アドレス を コールし ます. ルーチン を コールす る 前に 値が ポ 
ィ ンタで 指定され たと ころから レジスタに ロー ド され， ルーチンから リ ターンす る 際に レジスタ 
の 内容が 同 じ 所に コピー されます. 

指定 さ れた アドレス を 含む ページ だ け が 表 に 出ます. 

TINY rdslt(slot.adr) 
TINY slot ； 
NAT adr ； 

指定され た スロッ 卜の 指定され たァ ドレスの 内容 を 返します. 

VOID wrslt (slot , adr, value) 

TINY slot ； 

NAT adr ； 

TINY value ； 

指定 された スロット の 指定 さ れた アドレスに， デー タを 書き込みます. 

VOID callx (adrs, reg) 
NAT adrs ； 
REGS *reg ； 

現在 選択され ている スロッ トの 指定され たァ ドレス を コールし ます. ルーチン を コールす る 前 
に 値が ポィ ンタで 指定され たと ころから Z80 の レジスタに ロー ド され ルーチンから リ ターンす 
る 際に Z80 の レジスタの 内容が 同じと ころに コピー されます. この 関数 は 通常の ァ ドレス をコー 
ル する ための ものです が， MSX-DOS の 環境で は 次の ような 使い方 もで きます. 
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Kdef i ne BDOS 0x5 

#def ine GETDATE (NAT)0x2a 



getdate(y, m, d) 
i nt *y, td; 
{ 

REGS r; 

r.bc = GETDATE; 
callx(BDOS, 8r); 
*y = r,hl ； 
*m = r.de / 256； 
U = r.de % 256； 



5.4.2 BIOS を 呼 ふ 関数 



VOID inifnkO 



ファンクションキーの 内棼を ディ フォルト に 戻します 



VOID disscrO 



スクリーンの 表示 を 禁止し ます. 



VOID enascrO 

ソ 

スクリーンの 表示 を 許可し ます. 

VOID screen (mode) 
TINY mode ； 

スクリーン モー ドを 変更し ます. 無効な モー ド （MSX 上で 4 から 8 を 指定した など） に対して 
の 動作 は 保証され ません. 
なお， スクリーンモードに ついては， MSX-BASIC の マニュアル を 御 参照 下さい. 

VOID giciniO 

PSG を 初期化し ます， 
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VOID sound (reg'val) 
TINY reg ； 
TINY val ； 

PSG の レジスタに データ を 害き 込みます. 

reg で PSG レジスタ， val で 出力 データ を 指定し ます. PSG の データに ついての 詳細 は MSX 
-BASIC の SOUND 文に ついての 解説 や， 「MSX2 テクニカル ハンドブック」 等 を ご覧 下さ 
い. 

TINY rdpsg(reg) 
TINY reg ； 

PSG の 指定され た レジスタの 内容 を 返します. 

BOOL chsnsO 

キー ボー ド からの 入力が あれば 1 を， なければ 0 を 返します. 

char chgetO 

キーボードから 1 文 字 入力し ま す， 

VOID chput(c) 
char c ； 

テキス 卜 スクリーンに 1 文字 出力し ます. 

BOOL Iptout(c) 
char c ； 

プリンタに 1 文字 出力し ます. 出力に 成功 すれば 1 を， Contro 卜 STOP で 中断 されれば 0 を 返 
します. 

BOOL IptsttO 

プリ ンタが READY であるなら 1 を， そうでないなら 0 を 返します， 
char *pinlin() 
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スク リーン エディタ を 起動し ます. キヤ リ ッジリ ターンが 押される とその 時点で 力一 ソルが あ 

つた 行の 内容への ボイ ンタを 返します. Contro 卜 STOP か ControK: が 押される と NULL への 
ポインタが 返されます. pinlin を 呼んだ ときの 力 一ソルの X 座標に かかわらず， 常に 行の先頭 か 
らの 内容 を 返します. 

char *inlin() 

pinlin とほ ぼ 同じです が inlin を 呼んだ 時の カーソルの X 座標 以降の 内容し か 返しません. た 
だ し カー ソ ルの Y 座標が 変わ つたと き は 行の先頭 か らの 内容 を 返します. プロンプト メッセージ 
を 伴った 入力の 時に 便利です. 

BOOL breakxO 

Contro 卜 STOP が 押 さ れて C ゝれば 1 を， そうでな ければ 0 を 返します. 
VOID beepO 

ビープ 音 を 発生し ます. 
VOID cls() 

スクリーンの 表示 を 消します. テキスト スクリーン でも グラフ ィ ック スクリーン でも 有効です. 

VOID locate (csrx.csry) 
TINY csrx,csry ； 

リ 

テキス 卜 力一 ソルの 位 E を 指定し ます. 
VOID erafnkO 

ファンク シ ヨン キーの 表示 を 消します. 
VOID dspfnkO 

ファンク ショ ン キー を 表示し ます. 

TINY gtstck(port) 
TINY port ； 
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mm その他の 関数 



ジョイ ス ティ ックの 状態 を 調べます. 

port で 調べたい ジョイ ス ティ ック ポート を 指定し ます. ジョイ ス ティ ック ポートと 戻り 値 は 次 



port: 0 カーソル キー 

1 ジョイスティック #1 
2 ジョイスティック #2 

戻り 値 ： 方向に 応じて 0 から 8 が 返される ♦ 

gttrig(trig) 
trig ； 

ト リガ ボタンの 状態 を 調べます. 

trig で 調べたい ト リ ガー ボタ ンの 番号 を 指定し ます. 戻り 値 は ト リ ガーが 押されて いれば 1， さ 
もなければ 0 が 返される. 
ト リ ガ ボタ ンの 番号と 実際の 装置 と の 対応 は 以下の とおり. 



通常 時 



0 


スペース キー 


1 


ジョイスティック #1 のト リガ ボタン 1 


2 


ショィ スティック #2 の 卜 リガ ボタン 1 


3 


ジョイスティック #1 のト リガ ボタン 2 


4 


ショ イス ティ ック #2 の トリガ ボタン 2 


マウス 使用 時 


1 


マウス 1 の 左 ボタン 


2 


マウス 2 の 左 ボタン 


3 


マウス 1 の 右 ボタン 




マウス 2 の 右 ボタン 



TINY gtpad(pad) 
TINY pad ； 

各種の 入出力 装 E の 状態 を 調べます. 本 関数で 扱う ことので きる 装置 は， タ ツチ バネル， ライ 
ト ペン， マウス， トラック ボールな どです. 

pad で 調べたい 装置の ID を 与え， 戻り 値で 状態 を 知る ことができます. 装置 ID と 戻り 値の 関 
係 は 以下の通りです. 



のとお り. 



BOOL 
TINY 
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装置 ID 


指定され る 装置 


返って くる 情報 


0 

2 
3 


タ ツチ バネル 1 


パネ ルに 触つ ていれば OFFH , そうでな ければ 00H 
X 座標 (0 から 255) 
Y 座標 (0 から 255) 

ボ タ ンが押 さ れて レ > れば 0FFII ，いな け れば 001- I 


4 
5 
6 


タ ツチ パネル 2 


同 上 


8 
9 
丄， j 
11 


ライ ト ペン 


0FFII であれば データ 有効. 00H であれば 無効 
X 座標 (0 から 255) 
I mm \\) カゝ つ L\y^) 

ス イツ チが押 さ れて いれば 0FFH ，いな ければ 00H 


12 
13 
14 

15 


マウス 1 または 
卜 ラ ック ボール 


常に OFFH を 返す （入力 要求に 用いる） 
X 方向の 変位 (-128 から 127) 

I ノ J l"J v ノ iKjJA \ 1 厶 0 "ュっ ICi ) 

常に O0H を 返す （意味な し） 


16 

17 
18 
19 


マウス 2 また は 
トラック ホー ノレ 


同 上 



；主息 



一》 主意 2 _ 

注意 3 



ライ ト ペンの 座標 (pad=9,10) とスィ ツチ （pad=ll) の 情報 は pad=8 と して BIOS 
を コールした とき 同時に 読み込 まれて バッファリング されます がのと きの 戻り 値が 
0FFH の 時 だけ 同時に 読み込まれた 他の 値が 有効と な り ま す. 
マウスと トラック ボール は 自動 判別 します. 

マウス や 卜 ラック ボールの 座標 を 求める 場合まず 入力 要求 を 行い， その後に 実際に 座 
標を 求める コール を するとい う 手順 を 踏みます. このと き 2 つの コールの 時間 間隔 を 
できるだけ 小さく して 下さい. 入力 要求から 座標の 入力 要求までの 間が 必要 以上に 開 
く と 得られた データ は 保証され ません. 



TINY gtpdl(pdl) 
TINY pdl ； 

指定され た パドルの 内容 を 読みます. 



VOID chgsnd(onoff) 
BOOL onoff ； 



サウンド ポートの ビッ トの オン， オフ を 行う ことにより 音 を 発生し ます. data が 0 のとき 才 
フ， 0 以外の 時 オンと なり ます. 
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TINY snsmat(row; 
TINY row ； 

キー マ ト リ タスの row で 指定した 行の 値 を 読みます. 

戻り 値の 押されて いる キーに 対応す るビッ 卜が 0 になり ます. MSX のキ一 マ ト リク ス につい 
て は 「MSX2 テクニカル ハンドブック」 を ご覧 下さい， 

VOID kilbufO 

キーボード バッファの 内容 をす ベて ク リアし ます. 

5.4.3 その他 



NAT rnd (range) 
NAT range ； 

0 から range — 1 までの 範囲で ランダムな 整数 を 返します. 
VOID di() 

割り込み を 禁止し ます， 
VOID ei() 

割り込み を 許可し ます. 
BOOL msx2() 

MSX の バージョン を 調べます. 使用 中の マシンが MSX2 な ら ば 真， MSX な ら ば 偽 力 《返 され ま 
す. 本 関数 は， msxbios.h の 中で 定義され ている #define マクロです， 

char *fnkstr(fkey) 
TINY fkey ； 

指定され た ファンクションキーの 内容 を 保持して いる エリ ァ への ボイ ンタを 返します. fkey は 
1 か ら 10 ま でで なければ な りません. こ れは 実際に は msxbios . h で 定義 されて いる マクロ です. 
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第 6 章 —カー ソ〗 140 御 関数 パッケージ 



6. 1 カーソル 制御, 数 (MSX-CURSES)g« 要 

CURSES が UNIX の テキスト 画面 を 扱うた めの ライブラリ 関数 群で ある こ と は 既に 述べ ま し 
た. MSX- CURSES は， UNIX の CURSES の 中心的な 関数に ついては ほぼ サポートし ており， 
根本的な 原理 も 同じで あると いって 良いで しょう. ただし， 個々 の 関数で 若干 仕様の 異なる もの 
が あ り ， その 点 注意が 必要です. 

しかし， UNIX の CURSES を 使った $2 験の ある 方で したら， 6 . 4 の 関数 リファレンス を ご覧に 
なる だけで， UNIX の CURSES との 違い を 把握し， すぐにで も プログラムが 可能でしょう. た ^ 
だ， そうした 方 はごく まれ だと 思われ ますし， MSX-CURSES をより 有効に お使いい ただく ため 
に は ある 程度の CURSES の 原理に 関する 理解 は 必要でしょう， そこで， 本節で はまず はじめに， 
MSX-CURSES の 基本的な 概念と その 原理に ついて 解説した 後， MSX- CURSES を 構成す る 関 
数 を 総括的に 見渡して みましょう. 

B.l.l MSX-CURSES の 画面 更新 最適化の 原理 



A) 用 |g<7) 解説 

MSX- CURSES の 原理に ついて 解説す るに 先立ち， 解説 中で 統一的に 用いられる 概念 を 表す 用 
語の 解説 を 行います. 

実際の テレビ や モニタの 画面の こと. 実 両面 や， コンソール 画面と 呼ぶ 場合 も あ 
ります. 

物理 両面の ある 領域に 現在 どのような 表示が なされて いるか， あるいは， どのよ 
う な 表示が な されるべき かとい う イメージ を 常に 保存す る 一種の バ ッ ファ. MSX 
-CURSES では この ノ 《ッ ファ 領域と H 面 上の 位置な どの 情報 を 含め， WINDOW 
型の 構造体 として ウィンドウ を 扱います. 

論理 カーソル 各 ウィンドウ は それぞれの 構造体に ウィンドウ バッファ 上の 仮想 的な カーソル 位 
置の 情報 も 保存して います. ウィンドウ への 書 き 込み は こ の 論理 力 一 ソ ル 位置に 
行われ， 書き込み 終了 と 同時に 最後に 書き込んだ 位 {fl の 1 つ 後ろに 移動し ま す. 



ウィンドウ 



スクリーン 



物理 画面い つばい （フル スク リーン） の ウィンドウ を 特に スク リーンと 呼びます. 
スクリーン， ウィンドウ を 総^ f; して 論理 画面と 呼びます. 
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B) 最適化の 雕 

MSX-CURSES の 目的 は， 画面に 文字 を 表示す る 際に， できるだけ 効率よ く 画面の 書換え を 行 
なう という ことに 尽きます. この こと を 画面 更新の 最適化と 呼んで います. 

MSX-CURSES では UNIX の CURSES と 同様に スタン ダー ドス クリーン （stdscr) と カレン 
トス クリーン （curscr) という 二つの スクリーン を 用いる ことにより 画面 更新の 最適化 を 行います. 
二つの スクリーン は メモリ 上に バッファ 領域と して， それぞれ (画面 幅 x 行数) バイ ト （すなわち， 
物理 画面の 大き さ と 同じ） の 大きさ を 持ちます， 二つの スクリーンの 用途 はだいたい 以下のと おり 
です. 

スタンダード スクリーン MSX- CURSES のスク リーンへの 書き込み ルーチン （addch,addstr 

な ど） は 物理 画面 にで はなく この スタンダード スクリーンに 対し 寄き 
込み を そ亍 う. 書き込み を 行う 座標 は 論理 力 一 ソ ル 位置に よ り 決定す る . 

カレント スクリーン 実際の 画面の イメージ を 常に 保存す る. ス タンダー ドス ク リーン やそ 

の 他の ウィンドウ， スクリーン に対して 行われた 更新 を 実 画面に 反映 
させる （これ を 画面の リフレッシュ という） 際に カレント スクリーンの 
内容 (すな わ ち 現在の 画面 表示の 状態） と 比較 し 変化の あった 部分 だ け 
を 実 画面に 表示す る ことになる. 同時に カレント スク リーンの 更新 も 
おこなわれ 次回の 書き込みに 備える， 



もう 少し 具体的に 述べて みましょう. 

ま ず， MSX-CURSES の 関数 群 を 使用す る 前提と して CURSES の 初期化 ル一チ ンを 呼び出 さ 
なくて はなり ません， 初期化 ルーチン （initscrO) では， 上記 2 つの スクリーン バッファの ための メ 
モリが 確保され， 両 スクリーン は 20H (スペース コード） で 埋められます. 論理 カーソル 位置 はホ 
—ム ポジションに 初期化 されます. 

ここで スタンダード スクリーンへの 書き込み ルーチン により， 例えば 

addstr("Helio!!!"); 

というよ うにす ると， スタンダード スクリーンの g 上 行の先頭から" Hello! ！ ！，， という 文字列 
が 書き込まれ 論理 カーソル 位置が 最後の" ！ "の 直後に 移動し ます ♦ この 時点で は 実際の 実 画面に 
は 何も 表示され ません. スタンダード スクリーンに 行われた 書き込み を 実 画面 に 反映す る に は リ 
フ レ ッシュ を 行わなければ な り ま せん. 上の 関数 呼び出しに 続いて， 

ref reshO ； 

とする ことにより， はじめて 実際の スクリーン 画面に Hello ！ ！ ！と 表示され ます. 
refreshO では， スタンダード スク リーンと カレン トス クリーン を 頭から 1 文字ず つ J: 匕較 してい 
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き， 一致し なかった 文字 だけ を カレント スクリーンに コピーし， 同時に 実 画面に も 表示す るので 
す. この 例で は， カレント スクリーン はすべ て スペースで 埋められて いますから （雨 而がク リア さ 

れた 直後の 状態） Hello! ！ ！ という 文字列 だけが 表示され ます. さらに 引続き， 

move(0, 0)； 

adds tr("YeM ow!!"); 

ref reshO; 

とすると どうでしょう. まず move によって 論理 カーソルの 位置 を ホームに 戻してから ス タンダ 
一 ドス クリーンへの 書き込み を 行なって います. これによ り スタンダード スク リーンに は" 
Yellow ！ ！" の 文字列が" Hello ！ ！ ！" に 上書きされ ました. 
ここで refresh () の 行う 動作 を 追ってみ ま す. 

まず，" Y" と，， H" が 比較され， 一致し ないた め 実 画面の 左上 はしに" Y" が 表示され カレン 
トス ク リーンに も" H" にかわって" Y" の キャラクター コードが 書かれます， スタンダード スク 
リーン も カレン 卜 スクリーン も 次の 文字 は" e" です か ら な に も し ま せ ん， " o" ま では 一致 し 続け 
ますから 同様です." w" でよう やく 2 文字 目の 表示 力く 行われます. それ 以降 は 画面の 最後まで (嵌 
後の，， ！ " 以降 は どちらも スペースで 埋まって いるから 一致す る） 実際の 画面 更新 は 起こらず リ フ 
レッシュ を 終了し ます. 以上で 画面 更新 最適化の アル ゴリ ズムの 基本的な 部分が 理解いた だけた 
と 思います. 

MSX-CURSES では この ほか に も 画面の 書換 え をより 効率よ く 行うた め に 多 く の 内部的な ェ 
夫が な さ れて いま す. 例えば， refreshO は 呼ばれる 毎 に 全ての 文字 比較 をお こなう ので は な く 変 
更 のあった 行の 変更され た 範囲に 限って 比較 をお こなう といった 具合いです. 

およそ CURSES な ど どいつた UNIX 流の ライブラリに， はじめて 接する 方に とって は 以上 の 
説明 は 甚だ 不足して いるかと 思われます. MSX-CURSES の 実用 性に ついても 疑い を もたれる 方 
も 多いで しょう. しかし， MSX-CURSES の 関数 群 を， その 特性 を 理解し 活用す る ことによって 
UNIX の vi のよう な エディ タ を 最小限の 労力で 作成す る こ と も 十分に 可能で あると 考えます • さ 
らに MSX- CURSES の 画面 更新の 実効 性に ついて も， 付属の サンプル プロ グラム を 実際に 動か 
す こと で 実感して いた だけ る と 思い ま す. 

6.1.2 ウィンドウ 

CURSES では， 画面 上の 任意の 位置に 任意の 大 きさの ウィンドウ を 開き 各 ウィンドウ について 
その 内容の 更新 を 行う こ とがで きます. addchO に は waddchO, moveO に は wmoveO のよう に 
スタン ダー ドス ク リー ン への 書き込み 関数の 名前に "w" をつ けた も のが 同一 機能の ウィンドウ を 
扱う 関数です. 

ス タ ンダー ドス ク リーン や カレント スク リーン も フル スク リーン （画面 いっぱい） の ウイ ン ドウ 
と 瑚 解す る ことができ， データ 構造 も ユーザ が newwin () 関数に より 開 いた ウィンドウ とまつ た 
く 同じです， したがって スタンダード スク リーン を 扱う 関数の 大半 は ウイ ン ドウ を 扱う 閧数 を， 
stdscr (ス タンダー ドス ク リーン） という ウイ ン ドウ を 引き数と して 呼び出して いるに 過ぎません. 
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たとえば addch(ch) は waddch(stdscr，ch) という 呼び出し をお こない ます. 

さらに， リフレッシュに ついても wrefreshO という 関数が あり， ウィンドウ 毎に 行う ことが で 
き るので す. 

6,1,3 MSX-CURSES 関数 パッケージの 概要 

ここで は， MSX-CURSES の 関数 群 を 機能の 面から 下の ような グループ にわけ， 簡単に 紹介し 
ていきます. 

• 初期化， オプション モードの 設定 
• 論理 画面への 害き 込み 
• コンソール 画面の 更新 
• 論理 画面からの 入力 
• コンソールからの 入力 



A) 初期化， ね シ ヨン モードの 雖 

MSX-CURSES の 関数 を 用いる ために は 前述した よう なバッ ファ 等の 初期化 を 行わなければ 
なりません. さらに 画面 更新 時に 画面 を はみ出した ときの 処理 を どうす るか， などの モード 指定 
が 可能です. 



B) 論理 醒 への 書き込み 関数 

MSX-CURSES に おいて は， 前述の ように， ウィンドウ や スタンダード スクリーンへの 書き込 
みと リフレッシュ の 繰 り 返しに より 画面への 文字の 出力が 行われ ます. ウィンドウ ゃス タンダー 
ドス クリーンへの 書き込み ルーチンに は， 単に 文字 や 文字列 を 書き込む だけでなく， 行 や 文字の 
削除お よ び 挿入， 行の スクロール， 標準 関数の printf () に 匹敵す るよう な 書式 付 きの 書き込み を 行 
う ルーチンな どもあります. 



C) コンソール 画面への 出力 を 行う 関数 

コンソール 画面への 文字 出力 を 行う 関数 は， 前述の refreshO と wrefreshO です. この 関数 はス 
タンダ一 ドス クリーン や ウィンドウ について 設定され た オプション モードに 従って， つねに 最も 
効率の よい 画面 更新 を 行います. リフレッシュ では Ifl 面 を 更新す ると 同時に， カレン トス クリ— 
ンの 更新 も 行います. 

D) 論理 画面 か 6© 入力 関数 

MSX-CURSES に は ウィンドウ や スクリーンから 情報 を 得る ための 関数 も ffj 意され ています 
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すなわち， 現在の 論理 カーソルの 位置 や， カーソル 位置に ある 文字 を 知る ことができます. これ 
らの 関数 を 用いれば， 例えば 画面に メニューの 一覧が 表示され， 実行したい 機能 を メニュー 表示 
に カーソル キー を 合わせて リターン キー をお す ことにより 任意に 選べるな どの， ビジュアルな コ 
マンド を 作成す る こと もで きる でしよう. 



E) コンソール か 605 入力 ルーチン 関数 

コンソ 一 ルか ら の 入力で は， キ 一 ボ 一 ド か ら 入力 さ れた 文字 を 画面に エコーバック する かどう 
か を 設定す る こ とがで きます. 

コ ン ソール 入力 関数と して は， コンソールの キー ボー ド から コンソール モー ドに 従って 文字 や， 
文字列の 入力 を 行う 関数が あり ます. 



B.E MSX-CURSES 関数 パッケージの 使用法 

MSX-CURSES の 各 関数 を 用いる 際に は， ソース プログラム 内で curses. h をィ ンク ルードす 
る 必要が あり ます. 

ライ ブラ リ ファイル は mlib.rel で， これ をリ ンク 時に ユーザ プログラムよ り 前にお きます. 
FPC による パラメータ チェック の 際に は mlib. tco を チェック の 対照 としなくて はなり ま せん. 
以上， コンパイルから リ ンク までの 手順 は msx に bat という バッチ ファイルで 提供され ています, 



6.3 MSX-CURSES 関数 一覧 



初期化 処理， オプション モードの 設定な ど 



関数 名 



用 途 



参照 ページ 



mitscr 



MSX CURSES を 用いる ための 初期化 を 行う 関数 
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newwin 



新たに ウイ ン ドウ を 開く 



78 



sub 職 1 



ウイ ン ドウ 内に 新しい ウイ ン ドウ を 開く 



78 



end win 



CURSES を 用いた プログラム を 終了 するとき に 呼ぶ 関数 
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mvwm 



ウイ ン ドウの ホーム ポジ ショ ンの 座標 変更 
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delwin 



ウィンドウ を 閉じる 



79 



scrollok 



力 一 ソ ルがス クリーンから はみ出し た 場合の 処理 決定 



79 



フ 4 



第 6$ カーソル 制御 開 数バッ ケージ 



コンソール 出力 関数 



関数 名 


用 途 


参照べ- 


-ジ 


refresh 


実 画面の 更新 を 行う 




80 


wrefresh 


〃 




80 


論理 画面への 害き 込み 関数 


関数 名 


用 途 


参照べ- 


ージ 


move 


論理 カーソル 位置の 移動 




80 


wmove 


/； 




80 


addch 


現在の 論理 カーソル 位置に 1 文字 書き込む 




80 


waddch 


〃 




80 


mvaddch 


論理 カーソル を 任意の 位置に 移動 後 1 文字 書き込む 




81 


mvwaddch 


n 




81 


addstr 


現在の 論理 力 一 ソ ルの 位置に 文字列 を 書き込む 




81 


waddstr 


〃 




81 


mvaddstr 


論理 カーソル を 移動 後 文字列 を 書き込む 




81 


mvwaddstr 


n 




82 


box 


ウィンドウ を 指定した キャラクタで 囲む 




82 


overwrite 


ウィンドウから 別の ウィンドウに バッファの 内容 をコピ 


一す る 


82 


touchwin 


画面 更新の 最適化の ための 情報 を 無効に し 次回の リフ レツ シュ 時に ゥ 
イン ドウの 全面に 比較 を 行う 82 


erase 


論理 画面 を スペースで うめる 




83 


werase 






83 


clear 


ウィンドウ をク リアす る 




83 


wclear 


" 83 


clearok 


ク リア フラグの オン， オフ を 行う 




83 


clrtobot 


論理 力 一 ソ ル位 置か ら 画面の 右端まで をク リアす る 




84 


wclrtobot 


)) 




84 


clrtoeol 


論理 カーソル 位置から その 行末まで をク リアす る 




84 


wclrtoeol 


ガ 




84 


delch 


論理 力一 ソル 位 E の 1 文字 を 削除す る 




84 


wdelch 






84 


mvdelch 


論理 カーソル を 移動 後 〗 文字 を 削除す る 




84 


mvwdelch 


〃 




84 


deletein 


論理 カーソル 位置の 1 行 を 削除す る 




84 


wdeleteln 


n 




85 


insertln 


論理 力 一 ソル 位置に 空行 1 行 を 挿入す る 




85 


winsertln 


〃 




85 
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関数 名 


用 途 参照 ページ 


scroll 


ウィンドウ 内で 1 行 スクロール を 行う 85 


insch 


カーソル 位置に 1 文字 挿入 8 5 


winsch 


" 85 


mvinsch 


論理 力 一 ゾ ル を 移動 後 その 位 g に 1 文字 挿入 85 


mvwinsch 


ノゾ 85 


printw 


ウィンド ゥ への 書式 付 き ffl: き 込み 8(3 


wprintw 


ノノ 86 


mvprintw 


論理 力 一 ゾ ル を 移動 後の 書式 付 き 書き込み 86 


mvwprintw 


" 86 


論理 画面からの 入力 関数 


関数 名 


用 途 参照 ページ 


inch 


論理 力 一 ソ ル 位置の 文字 を 返す 86 


winch 


" 86 


mvinch 


論理 力 一 ソ ル を 移動 後 力 ― ソ ル 位置の 1 文字 を 返す 86 


mvwinch 


〃 86 


getyx 


現在の 論理 力 一 ソ ル位 H を 返す 87 


コンソールからの 入力 関数 


関数 名 


用 途 参照べ ージ 


echo 


コンソール キーボードから 入力 を 行う 際に 入力され た 文字 を 画面に 表 
示す る か ど うかの 決定 をす る 87 


noecho 


〃 87 


getch 


コ ン ソ ール キー ボー ドから ウィン ド ゥ の 論理 力 一 ソ ル位 g に 1 文字 読 
み 込む 87 


wgetch 


〃 87 


mvgetch 


論现 力 一 ソ ル 移動 後 getch 0 ， wgetch 0 に より コンソ 一 ルか ら 1 文字 
を 読み込む 87 


mvwgetch 


〃 87 


getstr 


コンソール キーボードから ウイ ン ドウの カーソル 位 g に 1 行 読み込む 87 


wgetstr 


〃 88 


mvgetstr 


論理 力 一 ソ ルの 移動 後 コンソ 一ルか ら ウィンドウに 1 行 読み込む 88 


mvwgetstr 


" 88 



注意 1 関数 名で， 先頭に， w ，がっかな いものと， ，w ，のつ く ものが ある 場合， 前者が ス タンダー 

ドス クリーン を 扱う 関数で， 後者が 同一 機能で， スタンダード スクリーン 以外の スク 
リーン や ウィンドウ を 扱う ものです. 
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6.4 MSX-CURSES 関数 リファレンス 



6,4,1 MSX-CURSES の システム 変数， データ 構造 

MSX-CURSES では 以下の よ う な 変数 名が 予約され て い ま す. ユーザ は こ れらの 名前 を ユーザ 
プログラム 内で 再定義す る こと はでき ません. また これらの 変数の 内容 を 変更す る 場合で も 
MSX-CURSES の 関数 を 介しての み 行う ことができます. 



A) システム 変数 

TINY LINES; 

TINY COLS; 

TINY Jty; 

WINDOW *stdscr; 

WINDOW Purser; 



コンソール 画面の 行数. initscrO によ り 初期化 される. 
コンソ 一 ル 画面の カラム 数. initscr () によ り 初期化 される. 
コ ン ソ一ル 入力 時の 入力 モー ド のフラ グ. 
ス タンダー ドス ク リーンへの ポィ ンタ 
力 レ ン トス クリ一 ン への ポィ ンタ 



B) ウィンドウの 《ii 

ウィン ドウの データの ための 構造体" WINDOW" は curses. h のなかで 次の よ う に 型 定義され 
ています. 通常 は これらの 構造体の 内容 を 直接 変更， 参照す る 必要はありません. 



「 产 へ 



O 論 3. カーソル 位 g 
C: ウィンドウの 大きさ 
o ホーム ポジションの 座標 
og 適 化に 用いる フラグ 
o ク リア フラグ 
o 未使用 

o スクロール フラグ 
o 各行 毎の 情報 



o 行 バッ ファ 

o 変更の あ つ た 最初の 力 ラ 厶 

o 最後の カラム 

o ハー ドゥエ アスク ロールの 

ための フラグ 



typeder struct { 

char *_y; 
i nt irsich; 

i nt _ lastch; 

i nt Jns_ck! に 

} indexlin; 



typedef struct { 
TINY 
Y 



1, 
L 
I- 

indexlin 
} window; 



. tfutxx, maxy 
be^x ， be^y 
f laf;s; 

„ c I ea r; 

.scrol I ； 
index; 



N t t o o o 

I M n o o o 

T i i B B B 
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6.4.2 初期化 処理， 7| ^ジョン モードの 離な ど 



WINDOW *initscr() 

MSX-CURSES の 各ル一 チン を 用いる 場合に は 必ず 呼ばなければ ならない 初期化の ための 関 
数です. 

stdscr (ス タ ン ダ一 ド スクリーン） と curscr (力 レント スクリーン） の 2 つの ウィンド ゥ 領域 を 確 
保し， これ を 初期化し ます. 戻り 値 は stdscr への ポインタが 返され ますが， 領域の 確保に 失敗し 
たと き は NULL を 返します. 

WINDOW *newwin(lines, cols, begin y, begin x) 
int lines, cols, begin ッ， gengin x ； 

新た に ウィンドウ を 開設 し ま す. lines, cols で ウィンドウ の 行数， 力 ラ ム数 を， begin_y ,begin_x 
で ウィンドウの ホーム ポジションの 位置 を 指定し ます， 

戻り 値 は WINDOW 型の 構造体への ポインタが 返され， 以後， これ を ffl いて ウィンドウ ヘア ク 
セス します. また， ウィンドウの ための バッファ 領域が 確保で きなかった 場合 NULL が 返され ま 
す. 

もし， lines, cois に 0 を 指定した 場合 

lines = LINES (物理 画面の 行数) 一 begin— y; 
cols = COLS (物理 画面の カラム 数） - besiri メ； 

となり ます. したがって フル スクリーンの ウイ ン ドウ （すなわち スク リーン） を 開きたい 場合 は 

WINDOW *fullwin; 

ful Iwin = newwi n(0, 0， 0, 0；； 

として 下さい. 

WIN DOW *subwin (win , lines , cols , begin^y , begin 一 x) 
WINDOW *win ； 

int lines, cols, begin— y, begin— x ； 

ウィンドウの 中に， 新しい ウイ ン ドウ を 開きます， newwin と 異なる 点 は， どちら かの ウィンド 
ゥ に 対 して 行われた 書き 込みが 他方に も 反映され る こと です. 
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win で 指定 した ウィンドウと バッファ エリア を 共有す る ウィンドウ が 開かれる わ けです. 

サブ ウィンドウの 位置と 大きさ は， win で 指定す る 外側の ウィンドウの 中に 入る ように 指定し 
なくて はなり ません. サブ ウィンドウの ための メモリが 足りなかったり， サブ ウィンドウの 位置 
や 大きさ が 不適当な 場合 NULL が 返 されます. 

VOID endwinO 

CURSES を 用いた プログラム を 終了 するとき に 呼ぶ ルーチンです. スクリーン データの ための 
バッファ 領域 を 解放し ます， 

STATUS mvwin (win , y , x) 
WINDOW *win ； 
int y,x ； 

ウィンドウの ホーム ポジションの 座標 を （ X ，y) に 移動し ます. もし （ X 、y) が コンソール 画面の 端 

を はみ出して しまう 場合， 本 関数 は ERROR を 返し， 移動 は 行われません. 

VOID delwin(win) 
WINDOW *win ； 

win で 指定 した ウィンドウ を 閉じます. ウィンドウの ための バッファ は 解放 さ れ ま す. delwin () 
で バッファ を 解放しても， 画面 表示に 影響 を 与えません. 

この ルーチンで サブ ウイ ン ドウ （ su bwin で 開設した ウィンドウ） を 閉じても， ウィンドウの バッ 
ファ 領域の 解放 は 行われません. 通常， 外側の ウィンドウ を 解放した 後， サブ ウィンドウ を 閉じ 
る ことにより， ノ 《ッ ファ 領域の 解放 を 行います， 

VOID scrollok(wiruboolf) 
WINDOW *win ； 
BOOL boo げ ； 

論理 カーソルが， ウィンドウ や スクリーンの 最下 行からの 改行 や， 最終 行の 最終 衍 での 文字 入 
力に より スク リー ンか ら はみ出 した 場合の 処理 を 決定 します. 本 ルーチンで b 00 if に true を し 
てす ると， 上記の 場合， 強制的に ウィンドウ 内で 1 行 スクロールが 起こります. 

逆に， boolf を FALSE で 実行す ると ウィンドウの スク ロールが 禁止 され， ウィンドウ の 右下 隅 
に 文字 は 出力され なくなります， 
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B.4.3 コンソール 出 カル" ン 



STATUS refresh () 

STATUS wrefresh(win) 
WINDOW *win ； 

実 画面への 表示 を 行います. スクリーン や ウィンドウへの 書き込み をお こなった 後に， リフレ 
ッシュ する ことにより はじめて 実 雨 面への 表示が 行われます. 同時に， カレント スクリーンの 更 
新 も 行います. 

refresh 0 はス タ ンダー ドス クリーン， wrefreshO は その他の スク リ 一 ンゃ ウイ ン ドウの 更新に 
用います. 

6.4.4 論理 画面への 書紛み ルーチン 



STATUS move(y.x) 
int y,x ； 

STATUS wmove (win , y , x) 
WINDOW *win ； 
int y,x ； 

論理 力 ― ソ ル 位置 を 移動 します. 

moveO では， スタンダード スク リーン" stdscr" 上の 論理 力一 ソル を （x，y) で 指定した 位置に 移 リ 

動し ます. y, x が 画面の 範囲 外の 時 は ERROR が 返されます. 

そ の 他の スクリーン や ウィンドウ の 論理 力 一 ソ ル は wmove 0 で 移動 します. 
スクリーン や ウィンドウへの 書き込み は 常に 論理 カー ソ ル位鍔 に対して 行わ れ ます. 

STATUS addch(ch) 
char ch ； 

STATUS waddch (win , ch) 
WINDOW *win ； 
char ch ； 

スクリーン や ウィンドウの 現在の 論理 カーソル 位^に 1 文字 を 書き込みます. ff き 込む キャラ 



80 



第 カー ゾル 制御 |« 数 パッケージ 



クタ を ch で 与えます. 

addchO は スタンダード スク リーンに 対しての S き 込み， waddchO は それ 以外の スクリーン や 
ウイ ン ドウに 対しての 書き込み を 行います. waddchO で S き 込み を 行う ウイ ン ドウ は win で 指 
定 します. 

文字 を 書き込む ことにより， ウィンドウ を はみ出す 場合， スクロールが 禁止され ている と 
ERROR となり ます. それ 以外の 場合 は 自動的に スクロールが 起こ り ます. 
(但し， 強制的に リフレ ッ シュが 起こ る こと は あ り ません.） 

STATUS mvaddch (y ,x ,ch) 
int y ヌ ； 

char ch ； 

STATUS mvwaddch (wi n ふ x , ch) 
WINDOW Hcwin ； 
int y,x ； 

char ch ； 

論理 力 一 ソ ルを 任意の 位置に 移動 後， 1 文字 を 書き込み ま す. 

論理 カーソルの 移動 先 を （x,y)， 書き込む キャラクタ を ch で 与えます. 論理 カーソルの 移動 先 
が 不適当で あったり， スクロールが 禁止され ている ウィンドウで， スクロールが 起こる ような 書 
き 込みが 行われた 場合 ERROR となり ます. 

STATUS addstr(str) 
char ネ str ； 

STATUS waddstr(win,str) 
WINDOW *win ； 
char 氺 str ； 

現在の 論理 力 一 ソルの あ る 位置に 文字列 を 書 き 込みます. 

書き込む 文字列への ポィ ンタを 引き数と して 渡します. addstrO や waddstrO は waddchO を 
文字 数 分 だけ 呼んで いる ので ERROR と な る 条件 は waddchO と 同 じです， 

STATUS mvaddstr (y.x, str) 

int y,x ； 

char *str ； 

STATUS mvwaddstr (win , y , x , str) 

WINDOW *win ； 
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int y,x; 
char *str ； 

論理 力 一 ソ ルを 移動 後， 文字列 の 書き込み をお こない ます 

(x,y) で 論理 力一 ソルの 移動 先， str は 書き込む 文字列への ポインタ を 渡します， ERROR の 返 
される 条件 は wmove, waddstr の 場合 と 同じです. 

STATUS box (win , vert , hor) 
WINDOW *win ； 
char vert , hor ； 

ウィンドウ 内 を 指定した キャラクタで 箱 状に 囲みます. 

vert で 垂直 枠の キャラクタ， hor で 水平 枠の キャラクタ を 与えます. 

本命 令 は ウィンドウに 枠 をつ けた い 場合に 用い られ ます. 通常， box () に よ り 枠 取 り をした ウイ 
ン ドウの 内部に 枠が 壊されな いような 大きさの サブ ウィンドウ を 開き， 書き込み は サブ ウイ ン ド 
ゥ に対して 行うな どに より 用います. 

I 呼び出し 例 | 

win = newwin(0, 0, 0， 0)； 

sub = subwin(win 9 (int)LINES - 2, (int)COLS - 2, 1， 1)； 
box(win, ，l，, に,〉； 

wrtwin(sub); /* 書き込み を 行う 関数 */ 

VOID overwrite (win 1 ,win2) 
WINDOW *winl, *win2 ； 

ウィンドウから 別の ウィンドウ に対して， ノ 《ッ ファの 内容の コピー を 行います. 
winl から W i n 2 に ウイ ン ドウの 重なった 部分の みが コ ピーされ ます. 2 つの ウィンド ゥに 重な 
つた 部分の まったくない 場合 に は コピー は 行わ れ ませ ん. 

STATUS touchwin (win) 
WINDOW *win ； 

画面 更新の 最適化の ための 情報 を 無効に し， 次回の リフレシュ 時に ウイ ン ドウ 全面の 比較 を 行 
うように します. 

CURSES では 一部 ま た は 全部が « なつ た ウィン ド ゥ を 交互に 更新した 場合， 画面 更新の 最適化 
処理が 逆に 災いして 正常に 更新され ません. touchwinO によ り 最適化 処理の 一部 を 無効に する こ 
と に より 重なりあった ウィンドウ を 交互に 更新す る 際に も ， 正常な 更新 を 行 うこと がで きま す' 
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具体的に は， 更新 （リフレッシュ） したい ウィンドウが 直前に 更新した ウィンドウと 異なり， か 
つ 2 つの ウィンドウに 重なった 領域が ある 場合に 今回 更新すべき ウィンドウ に対して 用います. 



r 呼び出 し 例 1 

STATUS func(wln) ノ * 重なりあった ウィンドウ を 更新す る 関数 *Z 

WINDOW ネ win; 

{ 

static WINDOW *lastwin = NULL; 

i f (lastwi n != win) { 
lastwi n - win; 
touchwin(win); 

} 

return(wref resh(win)); 



VOID erase 0 

VOID werase (win) 
WINDOW *win ； 

論理 画面 を スペースで 埋めます. eraseO でスク リーン をク リアしても， ク リ ァ フラグ はセッ ト 
されません. 

STATUS clearO 

STATUS wclear(win) 
WINDOW *win ； 

erase 0 を 呼び出した 後， 次の dearok () を 呼び出 しク リア フラグ を オンに します. 

wclearO で カレント スクリーン をク リアす ると， スタ ンダー ドス クリ一 ンが スペース ク リア さ 
れ， 強制的に リフレッシュ がお こ り 画面が ク リアされ ます. 本 関数 は ERROR を 返しません. （常 
に OK が 返される） 

VOID clearok(scr,boolf) 
WINDOW * SC r ； 
BOOL boolf ； 

ク リア フラグの オン， オフ を 行います. 

ク リア フラグが オンの スクリーンに たいして リフ レツ シュを 行う と， 物理 画面 をク リアした 後, 
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リフレッシュ をお こない ます. この 際， ク リア フラグ は 自動的に リセット （オフ） されます. 
ク リア フラグの オン， オフ は スクリーンに 対しての み 有効です. 

VOID clrtobotO 

VOID wclrtobot(win) 
WINDOW *win ； 

論理 力 一 ソ ルの 位置 か ら 論理 H 面の 右端 まで を スペースで ク リアし ます. 

VOID clrtoeoK) 

VOID wclrtoeoKwin; 
WINDOW *win ； 

論理 力 一 ソ ルの 位置 か ら その 行末まで を スペースで ク リアし ます. 

STATUS delchO 

STATUS wdelch(win) 
WINDOW *win ； 

論理 力 一 ソ ル 位置の 1 文字 を 削除 します. 
力一 ソル 位置より 右に ある 文字 はすべ て 1 文字ず つ 左に 詰められます. 本 関数 は ERROR を 返し 
ません. （常に 0K が 返される） 

STATUS mvdelch(y / x) 
int y,x ； 

STATUS mvwdelch (win , y , x) 

WINDOW *win ； 

int y,x ； 

論理 カーソル を 移動 後 1 文字 を 削除し ます. ERROR の 返される 条件 は， wmoveO と 同じで 
す. 

VOID deleteln () 

VOID wdeleteln(win) 
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WINDOW *win ； 

論理 力 一 ソ ル 位置の 1 行 を 削除 します. 

以降の 行が 1 行ず つ 上に 詰められ 最下 行 は 空行と なり ます. 

VOID insertlnO 

VOID winsertlruwirv 
WINDOW *win ； 

論理 力 一 ソ ル 位置に 空行 1 行 を 挿入 します. 

STATUS scroll (win) 
WINDOW *win ； 

ウィンドウ 内で 1 行 スクロール をお こない ます. ウィンドウの 最下 行 は 空行に なり ます. 

STATUS insch(ch) 
char ch ； 

STATUS winsch (win,ch) 
WINDOW *win ； 
char ch ； 

論理 力 一 ソ ル 位置に 1 文字 を 挿入 します. 

こ の 際 画面 か ら はみ出した 文字の デー タ は 失われて しまいます. 本 関数 は ERROR を 返し ませ 
ん. （常に OK が 返される） 

STATUS mvinsch (y 乂 ch) 
int y,x ； 

char ch ； 

STATUS mvwinsch (win , y , x , ch) 
WINDOW *win ； 
int y,x ； 

char ch ； 

論理 カーソル を 移動 した 後 その 位置に 1 文字 を 挿入し ま す. ERROR が 返 される 条件 は， 
wmoveO と 同じです. 
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STATUS printw (format , argl , arg2 ) 

char ネ format ； 

STATUS wprintw (win , format , arg 1 , arg2 ) 

WINDOW *win ； 

char *format ； 



STATUS mvprintw (y,x, format ,argl / arg2 ) 

int y,x ； 

char *format ； 

STATUS mvwprintw (win , y , x , format , arg 1 , arg2 ) 

WINDOW *win ； 

int y,x ； 

char *format ； 



6.4.5 論理 画面 か 60 入力 



char inch() 

char winch vwin) 
WINDOW *win ； 

論理 力 ― ソ ル位 E の 文字 を 返 します. 

関数の 戾 り 値と して 論理 カー ソ ル 位置の 1 文字が 返 されます. 

char mvinch (y,x) 
int y,x ； 

char mvwinch (win,y r x) 
WINDOW *win ； 
int y,x ； 

論理 力 一 ソ ル 移動 後の 論理 力 一 ソ ル 位置の 1 文字 を 返します. 
カー ソ ルの 移動 位置が 不適当 な 場合 ERROR が 返 されます. 
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VOID getyx(win,y,x) 
WINDOW *win ； 
int y,x ； 

指定 さ れた ウィンドウ の 現在の 論理 力 一 ソ ル 位置 を y ， x に 代入 します, 
こ の ルー チ ン は curses. h の 中で マ クロと して 定義 されて います • 

6.4.6 コンソール か 6© 入力 を^ よ う 関数 



VOID echo() 
VOID noechoO 

getchO や getstr () な どに より コンソールの キー ボ一 ド からの 入力 を 行う 際に 入力 さ れた 文字 
を 画面に エコーバックす るか どうか を 決定し ます • ec ho() で エコー オン， noechoO で エコー オフ 
です. 初期 状態 は エコー オンです. 

char getch () 

char wgetch (win) 
WINDOW *win ； 

コンソール キーボードから ウィンドウ の 論理 力 一 ソ ル 位置に 】 文字 読み込み ま す. getch 0 では 
スタンダード スクリーンに， wgetchO では 指定した ウィンドウに， それぞれ コンソールから コン 
ソ一ル モードに 従って， 1 文字 を 読み込みます. 

，¥r ，（キヤ リ ッジ リターン）， は， ¥i ゲ （ニュー ライン） に マツ ビング されます • 

char mvgetch ^y,x) 
int y f x ； 

char mvwgetch (win , y , x) 
WINDOW *win ； 
int y,x ； 

論理 カーソル を 移動 後， getchO, wgetchO により コンソールから 1 文字 を 読み込みます * 
カー ゾ ルの 移動 先が 不適切な 場合 （ウィンドウ を はみ出す 場合) ERROR が 返 されます 
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STATUS getstr(str) 
char *str ； 

STATUS wgetstr(win,str) 
WINDOW *win ； 
char *str ； 

コンソール キーボードから ウィン ドウの 論理 カーソル 位 g に， 1 行 を 読み込みます， ，¥n， が 入力 
される まで 読み込まれ， str で ボイ ン 卜される 文字 配列に 格納され ます 力;， この 際， ¥n は 除かれ 代 
わりに NUL(，¥0') が つめられます. 本 関数 は ERROR を 返しません. （常に OK が 返される） 

STATUS mvgetstr(y,x,str) ； 
int y,x ； 

char *str ； 

STATUS mvwgetstr (win , y , x , str) 
WINDOW *win ； 
int y,x ； 

char *str ； 

論理 力一 ソルの 移動 後， コンソールから ウィンドウ に対して， 1 行 を 読み込みます. 
力 一 ソ ルの 移動 先が 不適切な 場合 （ウィンドウ を はみ出す 場合) ERROR が 返されます. 
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付録 サンプル プログラム 集 



A) 数値 演算 パッケ-ジ を 用いた 力 グラム" den" について 



1 概要 

den は MSX- C ライブラリ パッケージに 含ま れ る 数値 演算 モ ジ ユール を 使用 し た 整数 型 16 進 
電卓 プログラムです （】0 進 計算 も 可). 通常の 電卓の ように メモリへの 代入， 参照 や カツ コ 計算 を 
含む 優先順位 を 考慮した 計算が でき ます， 

£ den の 使用例 

ここで は 簡単な 使用例 を 示します. 電卓と しての 詳細 は 次 頁の 「3 仕様」 を 参照して 下さい， 
den の 起動 は MSX-DOS プロンプトが 出て いる 時， den 0 と 入力す る だけです， すると， 
数値 モードの 文字 (D，U，X，0 のどれ か） が 左端に 表示され， その 右に 初期値 0 が 表示され ます. 

D 0 

数値 を 入力す ると 0 が 入力に あわせて 変化して いきます. 1350 と 入力す ると 表示 は， 

D 1350 
となります. 以下 入力と それに 対する 表示 を 示します. 



35 585 320586 

7 6 6Q,<66 1 

3 8 8 2 8 1 



示 

表 



II 

4T- 一一 3 o ( 5 

^ 3 5 o 2 m 7 t + 

入 + 2II*M:/ + -1X23. 
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このように ほとんど 普通の 電卓の ように 動作し ます. ただし， キーの 割り付けが C 言語 風な ので 

注意して 下さい. 



3 tt^ 

ここで は， den の 仕様と， キーの 割り付け を 説明し ます. キーの 割り付けに 使われる 文字 は大文 
字と 小文字の 区別が されます. 



3.1 数値 モード (基数） 

den の 数値 モー ド は， 符号つ き 10 進 と 符号 無 し 10 進， 16 進， 8 進の 4 種類が あ ります. 符号つ 
きと 符号な しの 違い は 商， 剰余 を 求める 場合と， 算術 右 シフト を 行う 場合に のみ 現れます. その 
他の 場合に 違い は 出て きません. 基数の 違い は 入力と 出力に 指定され た 基数 を 使って 行われる だ 
けにす ぎません. 数値 モードの 変更 は 次のようになります. 
符号つ き 10 進 ： D 
符号無し 10 進 ： U 
符号無し 16 進 ： X 
符号無し 8 進 ： 0 
数値 モード は 常に 数値 表示 欄の 左端に D,U,X，0 の 文字で 表示され ています， 



3.2 置 数 

置 数 (数字 を 入力す る こと） は 数値の 上位の 桁から 1 桁ず つ 入力し ます. 符号つ きで 負数 を 入力 
する 場合 は， o 以外の 数値 を 入力して から 符号 を 反転させる 文字 一 (アンダースコア） で 負数に しま 

す， 入力 を 間違えた 場合 は BS (BACKSPACE) キ 一 を 使用 する ことによって 1 桁ず つ 取 り 消す こ 
とがで きます. また， 入力され た 数値が 使用で きる 数値の 範囲 を 超えた 場合に は， 上位の 桁が な 
くなります. 置 数 時 有効な 文字 は 基数に よって 変わって きます. 使用で きる 文字 を 数値 モード 別 
に 示します. 



符号つ き 10 進 
符号無し 10 進 
符号無し 16 進 
符号無し 8 進 



0123456789 一 

0 1 2 3 4 5 6 7 8 9 

012 3 456789abcde 

0 1 2 3 4 5 6 7 



3.3 使用で き S» 値の 範囲 

den で 扱われる 数値 はすべ て SLONG 型 (32bit) となって います. それぞれの 数値 モー ドの 表現 
で 使用で きる 範囲 を 示します. 
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符号つ き 10 進 
符号無し 10 進 
符号無し 16 進 
符号無し 8 進 



-2147483648 から 2147483647 
0 から 4294967295 
0 力、 ら FFFFFFFF 
0 から 37777777777 



3.4 オール クリ ァ， ク リア, = 

オール ク リア は， 計算 を 始める 前に 行う ことで， それまでの 計算に 影響 を 受ける ことなく 実行 
する ことができます (表示 レジスタ， 数値 スタック， 演算子 スタック をク リアし ます). また クリ 
ァは， 置 数に 大幅な 間違いが 見つかった ときに 使用す る ことで， キー入力 数 を 少なく する ことが 
できます (表示 レジスタ のみ をク リアし ます ）.= は それまでの 入力 をす ベて 計算して， 結果 を 表示 
する のに 使います. 

A オール ク リア 

C ク リア 

リターン キ一 = と 同じ 



3.5 二 項 演算子お よび カツ コ 

二 項 演算子に は 加減乗除 • 剰余 （+ — *,%)， 論理 積 • 論理和 • 排他的 論理和 (&! へ ） が ありま 
す. おのおのの 演算子に は 優先順位が ついて おり， 優先順位の 高い 演算から 実行され ます. この 
優先順位 を 変更す るた めに は， 優先順位 を 上げたい ところで カツ コを 使用し ます. 優先順位の 顺 
位 表 を 示します. 順位 は 小さい 方が 優先 度が 高く， 優先順位が 同じ ものに ついては 式 を 入れた 順 



に 評価され ます. 

1 ( ) (カツ コ） 

^ 2 * / % (乗算， 除算， 剰余) 

3 + — （加算， 減算） 

4 & (論理 積） 

5 ！ (論理和） 

6 ^ (排他的 論理和） 



3.6 賴 演算子 

演算子に は 二 項 演算子の 他に 単項 演算子が あります. これ は 演算子の キー を 押す と， 表示され 
ている 数値に 演算 をし， 演» '結果 を 表示す る ものです. ですから 優先順位はありません (言い かえ 

ると 最高 位の 優先 度). 単項 演算子に は 否定 (not), シフト • ローテ イトが あります. 
^ (否定 ビットごとの 反転） 

く （左 シフト） 

> (右 シフト 符号 ありの 場合 は算 《f 右 シフト） 
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[ (左 ローティ 卜） 

j (右 ローティ 卜） 

{ (キャリー を 含んでの 左 口一 ティ 卜） 

} (キャリー を 含んでの 右 ローティ ト） 

シフトと ローティ 卜に 関して は 1 回の キー 操作で 1 ビットず つ 移動し ます. また， R 数 時に 使 
わ れ る 符号 反転 し） も こ の 単項 演算子の ひとつと 考え ら れ ま す. 



3,7 メモリ 機能 

メモリ 機能 は 4 種類 あり， 代入 • 参照 • 加算' 減算と なって ます. それぞれ 電卓 的 表現で， Min- 
MR'M+*M— となります. メモリ は 番号 0 から 9 までの 10 個が あります. メモリ を 使用す る 場 
合に は メ モ リ 機能の 操作 (下記 参照） に 1 桁の メ モ リ 番号 (0-9) を 指定し ます. メモリ 機能 は 次の よ 
うにな り ます. （# は メモリ 番号） 



M# メモリへの 代入 （Min〉 

m# メモリの 参照 （MR) 

M+# メモリへの 加 ff(M + ) 

M-# メモリからの 減算 (M — ) 



M+'M— に， イコール 機能はありません. また， 数値 モードが 変更され た 場合に は 現在の モ一 
ド で 表示 されます (符号 あ りと 符号な しが 混在 している 場合に は 注意が 必要です). 

4 コンパイル 方法 

den.com の ソース フ アイ ルは den.c です. 

コ ン パイ ルは C ライ ブラ リ に 含ま ォ 1 る msx に bat にコン バイ ルス ィ ツチ をつ けて コンパ ィ ル 
します， 

A>msxc den -r5:6:2 -r2000 IsfJ 



5 注意点 



5.1 O による 麟* 剰余 

サンプル として 含ま れて レ 、 る den は 0 による 除 • 剰余の エラー チェック を まったく 行って い 
ません. ですから， カツ コの 多い 複雑な 式 を 計算す る 場合に は 除数に ご注意 下さい. 
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付録 サン ブル プロ ダラム 集 



5.S カツ コの 機能に ついて 

den は カツ コ つきの 計算が できます 力 s その もとの 機能 は 少し 特殊です. 左 カツ コ， (，が 入力 さ 
れる と それ 以降の 演算の 優先 度 を 上げ， 右 力 ッコ' ) ， が 入力 さ れる とそれ に 対応す る 左 力 ッコ から 
右 カツ コ までの 計算 を 行います. ですから， 演算子 を 忘れて 左 カツ コを 入力しても den は それ を 
カツ コ として 受け付けます • 実際の 例 を 示す と， 2X3(+2)= と 入力す ると deii では 2X(3+ 
2)= と 入力され たものと 認識し ます， 
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B) グラフィック 関数 を 用いた^] グラム n gear について 
1 概要 

サンプル プログラム "gcal" は， グラフィック 関数 を 使って 2 力 月 分の カレンダ一 と バイオ 
リズム を グラフ ィ ック 画面に 描く という プログラムです. マシンが MSX の 場合 は 自動的に 
MSX 用 （スクリーンモード 2) が， MSX2 の 場合 は （スクリーン モー ド 5) が 動作 します. 

g 使用方法 

MSX-DOS の コマンド ラインより 次の よう な 入力 を 行って 下さい * 

gcal [/h] <yyyy/mrn/dd> <yyyy/wni/dd> 

最初の 曰 付 は 生年月日 を， 2 番目の 日付 は 調べたい 口 を 入力して 下さ レ、. 2 番目の 日付 は， 調べ 
たい 日 力く，， 今 曰" であると きに 限り 省略が 可能です. このと き は， MSX 内の CLOCK-IC から 呼 
び 出して きます ので， CLOCK-IC の 日付が， 正しい かどう か 確認され る こと をお すすめし ます. 
なお， 日付の 変更 方法 は， MSX- DOS TOOLS の MSX-DOS manual 第 2 部 を ご覧 下さ 
い. 日付の 区切り は， ，/，の ほかに， -，， ， ，（空白） が 使用で きます. カレンダ 一は， 2 番目の 日 
付の 月と， その 次の 月， バイオリズム は， 調べたい 日 を 中心に 41 日 分 を 表示し ます ."gcal" の あ 
とに，"/ h "オプション をつ ける ことによ り コマンド リファレンス を 表示， 参照す る ことができ ま 
す. 

3 コンパイル 方法 

gcal.com の ソースファイル は gcal .c です. 

コ ンバ ィルは C ライブラリに 含まれる msxc ,bat に コンパイル スィッチ をつ け て コンパイル 
します. 

A>msxc gcal -rl3:ii:4 -rl500 @ 



4 注意点 

動作が 終了す ると 停止 状態になります が， ，q，， ，Q ，又は ESC キー を 押す ことによって MSX - 
DOS に 戻ります. 但し， コントロール- STOP をして しまった 場合 は， グラフィック 画面の まま 
終了して しまい ま すので リ セ ッ ト を かけて 下さ い. 
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OMSX-CURSES を 用いた TP グラム" show" に ついて 

I 害 式 1 show filel [file2] 



I 機能 1 1 つまた は 2 つの ファイルの 内容 を 表示し ます. 

MSX-DOS のコ マン ドラ インで 1 つまた は 2 つの ファイル 名 を 与えて 起動す る ことのよ り 1 
〜 つめの ファイルの 1 ページ 目 が 表示され ます • そ の 後の コマンド とし て 以下の も のが 有^/です. 

ESC ファイル を 2 つ 指定した 場合 も う 一方の フ アイ ルに 表示 を 切 り 替えます. ファイル を 

1 つ し か 指定 し ない 場合 は 無効です. - 
RET 1 行 スクロール します. 

DOWN 5 fi 1 ス クロ ール し ま す. 
SPACE 次の ぺー ジ を 表示 し ま す. 
q/Q コマンド を 終了し ます. 
h/? ヘルプ を 表示し ます. 

SHOW は ファイル 表示の ための 2 つの ウイ ン ドウと 先頭 行の ステータス ライ ン 及び ヘルプ 表 
示の ための ウイ ン ドウの 計 4 つの ウィンドウ を もちいて います. MSX-CURSES の プロ ダラ ミ ン 
グ例 として ソースファイル を ご 参 照 ください. 
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お問い合わせ について 



弊社で は 厳重に 梱包した 上， 細心の 注意 を 払って 製品 を 発送して おります. 万一， 輸送 上の ト 
ラ ブルが 起 こった 場合 に は ご 一報 いただければ 新しい ものと 交換いた します. 

マニュアル 作成に あたり， なるべく 詳細な 説明 をす るよう に 心がけた つもりで すが， 理解で き 
ない ところ は， 実際に コンピュータと 向きあって 納得の いくまで 確かめて 下さい. また， 他の ぺ 
—ジを 参照す るの も ひとつの 方法です. それでも 疑問 点が 解決で きないと き は， 購入され た 販売 

店に 問い合わせ るか，㈱ アスキー ユーザー サ ポー 卜 （直通電話 03- 3498-0299) ま でお 電話いた だけ 
れば， 係が お答えし ます. しかしながら， 回線が 混み合い ご迷惑 を かける こと もあります ので， 
なるべくお 手紙に てお 願いいた します. その 際に は， 下記の 要領で 記入して 下さい. 記入され て 
ない 項目が一 つで もあります と， 回答で きかね る 場合が あります. 十分 注意して 下さい. 

また， 本 製品 以外に 対しての ご 意見， ご 希望が ございましたら， 弊社まで およせく ださい. ^ 

記 

1. 送付先 〒 107- 24 東京都 港 区 南 青山 6-11- 1 ス リー エフ 南 青山 ビル 

株式会社 アスキー ユーザー サポート 係 
TEL. 03-3498-0299 

(祝祭日 を 除く 月〜 金曜日， 10:00〜12:00, 13: 00 〜： 17: 00) 

2. 必要 項目 

(1) お客様の 氏名， 住所 (郵便番号)， 電話番号 (市外 局番 も 含む） 

(2) 製品 名， 製品 シリアル 番号 

(3) 機器 構成 

本体 装置 名， メモリ バイ ト数 

CRT 装 S 名， フロッピ一 ディスク 装置 名 

プリ ンタ 装置 名 

その他 I/O, I/F 装置 名 ^ 

(4) お問い合わせ 内容 

お問い合わせの 内容 は， できるだけ 製品の マニュアルに 記述され ている 用語 を 用いて， ft 
体 的 かつ 明確に 記述して ください. なお， 障害と 思われる 現象に ついては， その 現象 を 再現 
可能な 情報が 必要です. 当社で 再現で きない もの は， 調査が できません. その 現象が 発生す 
るまでの 操作 手順， データ を 必ず 添付して 下さい. データ ディスクが ある 場合 は， その コピ 
一 も 同封して いただく と 調査が スピーディ一 になります • 

また， お客様 固有と 思われる アプリケーションの 設計， 作成， 運用， 保守に ついては， 当 
社の サポート 範囲 外です ので， お問い合わせいた だいても 回答で きません * ご了承 下さい ま 
すよう お願いい たします. 
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